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(57) Abstract 

A job scheduling device providing a 
consistent set of application programming 
interfaces (APIs) compiled and linked into 
an individual or suite of programs to provide 
scheduling services on a single computer 
or- across multiple computing platforms, in- 
cludes a GUI API for retrieving and vali- 
dated job parameters, a job scheduling API 
for allocating jobs based on the job param- 
eters, and an enterprise scheduling agent 
hosted on one or more nodes of the com- 
puter platforms. An enterprise communica- 
tion agent sends messages containing jobs 
from a computer executing a program uti- 
lizing the job scheduling device to the en- 
terprise scheduling agent on a selected node 
where the job is to execute. Then, the enter- 
prise scheduling agent retrieves job param- 
eters and launches the job on the selected 
node. The enterprise scheduling agent main- 
tains a local job repository containing job 
information for each job run on its corre- 
sponding node and sends messages to a job 
data management API to maintain a cen- 
tral job repository containing information on 
jobs executed on all nodes. 
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SYSTEM FOR SCHEDULING AND. MONITORING COMPUTER 

PROCESSES — 



Background of the Invention 

Field of the Invention 

10 This invention relates to the scheduling and 

monitoring of computer processes. The invention is 
more particularly related to the submission of jobs for 
execution. The invention is still further related to 
the submission, scheduling and monitoring of jobs 

15 across multiple networked computer platforms (nodes) 
and the provision of a common interface for programs 
submitting to the jobs. 

The invention is still further related to a job 
scheduler that maintains local job repositories having 

20 detailed job histories for each node and a central job 
repository maintaining detailed job history across an 
enterprise. The invention is yet further related to 
the provision of a scheduling agent on each computer 
- platform to start execution of each job submitted. 

25 

Discussion of the Background 

Modern computer systems are utilized for a wide 
range of tasks. Many tasks are simple and are executed 
in real time. However, some tasks require long 
30 execution times, . or must be performed at various 
intervals or at inconvenient times (when a system where 
a task is running has a light tasking load, early 
morning or weekend hours, for example) . 

Basic scheduling devices have been utilized to run 
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certain programs or jobs at various intervals or at 
specified run times. However, these systems do not 
provide adequate service or integrate seamlessly into 
any specific product line, nor provide appropriate 
5 service between multiple computing platforms in a 
networked environment. 

SUMMARY OF THE INVENTION 
Accordingly, it is an object of this invention to 

10 provide a job scheduling apparatus for scheduling jobs. 

It is another object of the present invention to 
provide a job scheduling apparatus that provides job 
scheduling services across multiple computing 
platforms, and control over the execution of a job 

15 submitted; 

It is yet another object of the present invention 
to provide a scheduling agent on each respective node 
of a computer network for accepting and managing jobs 
submitted to the respective node; 

20 . It is another object of this invention to provide 

a command line that may be utilized to determine job 
status and issue job control commands to jobs executing 
on a node in an enterprise. 

It is another object of this invention to provide 

25 a seamless job scheduling device for plural software 
products having a common format for submission and 
scheduling of jobs, and to provide consistent 
application programming interfaces to the software 
products utilizing the job scheduling device. 

30 Jt is yet another object of this invention to 

provide a single job scheduling and administrative tool 
for all POEMS enabled products (Platinum point 
products, for example) under a common application 
programming interface that specif ically and efficiently 
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targets job scheduling requirement is of the products* 

It is yet another object of the present invention 
■to provide a common graphical user interface (Microsoft 
Foundation Class (MFC) , for example) to strhedule and 
5 "list all jobs and common APIs used by a GUI component 
and the agent. 

- > . ■ BRIEF DESCRIPTION OF THE DRAWINGS 

A more complete appreciation of the invention and 

10 ; many of the attendant advantages thereof will be 
readily obtained as the same becomes bettei: understood 
by reference to the following detailed description when 
considered in connection with the ' accompanying 
drawings, wherein: 

15 Figure 1 is a block diagram illustrating an 

implementation of the present invention providing a job 
scheduling and administrative tool for POEMS enabled 
products under a common application programming 
interface. 

20 Figure 2 is a block diagram of a Lightweight 

Enterprise Scheduler (LES) Agent that coordinates 
execution and job history submissions for a node; 

Figure 3 is a flow diagram illustrating an 
; RTserver utilized to communicate messages to Receive 
25 modules; 

Figure 4 is a flow diagram illustrating an 
RTserver utilized to communicate messages to Receive 
modules subscribed to a specific node; 

Figure 5 is a flow diagram illustrating LES agent 
30 . receipt of Platinum Enterprise Communicator (PEC) 
messages; 

Figure 6 is a flow diagram illustrating an LES 
agent sending point product parameters to a point 
product process via PEC; 
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Figure 7A is a flow chart illustrating startup of 
an LES agent ; 

Figure 7B is a flow chart illustrating the 
processes of an LES Agent; — 
5 Figure 8 is a block diagram illustrating, an LES 

directory structure; 

Figure 9 is a block diagram of a Platinum Security 
Model illustrating user identification requirements of 
applications and point products; 
10 Figure 10 is an illustration of a POEMS Scheduling 

Service : J ob Schedul ing window ; ... 

Figure : 11 is an illustration of a Point Product 
Property sheet; 

Figure 12 is an illustration of a pull-down 
15 calendar on a Point Product Property sheet; 
n Figure 13 is an illustration of an example job 

scheduled to run via the Point Product Property sheet ; 

Figure 14 is an illustration of a second example 
of a job scheduled to run via the Point Product 
20 Property sheet; 

Figure 15 is an illustration providing an example 
of a job scheduled to run every day; 

Figure 16 is an illustration that provides an 
- example of a job scheduled to run every week on a 
25 specific day; 

Figure 17 is an illustration providing an example 
of a job scheduled to run on a selected specific date 
of each month; 

Figure 18 is an illustration that provides an 
example of a job scheduled to run once a year on a 
specific date; 

Figure 19 is an illustration of a Notification 
Script window; 



30 
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Figure 20 is an illustration of a Calendar 
Selection window; 

Figure 21 is an illustration: of a Create Calendar 
window utilized to create a calendar havifig selected 
5 7, dates for running jobs associated with the calendar; 

Figure 22 is an illustration of an: existing 
: calendar brought up for editing; 

a r . Figure 23 is an illustration of- a Strategy 
Scheduling window utilized for- creating strategy 
ao . .windows and selecting strategy windows for editing and 
.deleting; 

Figure 24 is an illustration of a Point Product 
^Property sheet invoked by clicking Cfeate from the 
Strategy Scheduling window; ■)■■ 
15 Figure 25 is an illustration of a Delete -Schedule 

window having a prompt for identifying a: clean-up 
script upon deletion of a schedule; 

Figure 26 is ari illustration of an Insert Object 
window; 

20 Figure 27 is an illustration of a General tab of 

a properties window; 

Figure 28 is an illustration of a Representation 
tab of a properties window; 

Figure 29 is an illustration of a Select 
25 Intellicon bitmap utilized for selecting icon graphics 
for representing an object; 

Figure 30 is an illustration of an example in an 
Explorer view for the display of labels for a jobs 
resource object; 
30 Figure 31 is an. illustration of a Job Repository 

tab of a properties window; 

Figure 32 is an illustration of a hierarchy of 
folders of a jobs resource object; 
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Figure 33 is an illustration of a listing of jobs 
in All Jobs folder; 

Figure 34 is an illustration of a job in an All 
Jobs Any Status folder; — r 

Figure 35 is an illustration of an example of a 
Job 1 s Run history; 

Figure 36 is an illustration of a listing of jobs 
. in an All Jobs Any Status folder under a specific node; 

Figure 37 is an illustration of Property Page tabs 
that are available for jobs; 

Figure 38 is an illustration of a Command Tab 
property page; 

Figure 39 is an illustration of a Databases Tab 
property page; 

Figure 40 is an illustration of a Job Scheduling 
Tab property page; 

Figure 41 is an illustration of a Parameters Tab 
property page; 

Figure 42 is an illustration of a General Tab 
property page containing information about a job run; 

Figure 43 is an illustration of a Run Stats Tab 
property page that displays product specific 
information about a job run; 

Figure 44 is an illustration of a General Tab 
property page on the text of a group in a Jobs 
resources object; 

Figure 45 is an illustration of a view of a Log 
File column in a Director Explorer view; 

Figure 46 is an illustration of. utilization of a 
popup menu for viewing a Log File; ' 

Figure 47 is an illustration of a Log File viewer 
displayed for a specific job run; 



Figure 48 is an illustration of a popup menu 
utilized to delete a folder of jobs; 
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Figure 49 is an illustration of a Delete Jobs 
window; 

Figure 50 is an illustration of a Status and 
Results window; 
5 Figure 51 is an illustration of utilization of a 

popup menu to delete a single job; 

Figure 52 is an illustration of a Delete Jobs 
- windoW; 

Figure 53 is an illustration of a Status and 
10 Results window for the deletion of a single job; 

P; ; Figure 54 is an illustration of utilization of a 
popup window to evoke a reriih of multiple jobs at a 
folder level; 

Figure 55 is an illustration of a Rerun Jobs popup 
15 window; 

Figure 56 is an illustration of a Status and 
Results window for the rerun of jobs in a Jobs folder; 

Figure 57 is an illustration of a utilization of 
a popup window to rerun a single job; 
20 Figure 58 is an illustration of a Rerun Jobs 

window for an individual job; 

Figure 59 is an illustration of the utilization of 
a popup window to cancel running jobs; 

Figure 60 is an illustration of a Cancel Runs 
25 popup window; 

Figure 61 is an illustration of the utilization of 
a popup window to invoke a Progress Monitor on a 
running job; 

Figure 62 is an illustration of a Progress Monitor 
30 utilized by the present invention to show phase, 
overall prog and other specific information about a 
job; 

Figure 63 is an illustration of a Director Service 
Manager Monitor; and 
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Figure 64 is an illustration of a right side of a 
Service Manager Monitor displaying information for 
programs residing on a node. 

DESCRIPTION OF THE PREFERRED EMBODIMENTS 
Referring now to the drawings, wherein like 
reference numerals designate identical or corresponding 
parts throughout the several views, and more 
particularly to Figure 1 thereof, there is illustrated 
an implementation of the present invention providing a 
job scheduling and administrative tool for POEMS 
enabled products (Platinum point products, for; example) 
under a common application programming interface. 

In Fig. 1, a suite of point products 100 (point 
products 1. .n) , each including a point product GUI 110, 
are linked together with various POEMS enabling 
application programming interfaces (API's), and a 
Platinum Enterprise Communicator (PEC) 160. At least 
one Lightweight Enterprise Scheduler CLES) agent 170 is 
installed on a node. The point product GUI 110 
provides a user interface to the point product 100 and 
communicates user selections by sending job data to a 
GUI API 115. 

The GUI API 115 incorporates LES provided property 
pages, performs data checks and job allocation, and 
calls relevant scheduling functions in the job 
scheduling API 130 according to the job parameters. 
The GUI API 115 is used by the point product GUI 110. 

The job scheduling API 130 performs scheduling 
services, allocates and defines jobs submitted and 
distributes jobs by initiating a PEC message to an LBS 
agent on a selected node to run the job (LES node 1, 
170, for example) . Inter-process communications are 
performed via the PEC 160. The Job Scheduling API is 
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preferably used by the. point product GUI 110. 

The LES agent 170 initiates processing of the job 
as requested by the Job Scheduling API 130. The 
present invention may be implemented acress multiple 
5 confuting platforms arid/or ' nodes, and an LES agent is 
installed on each node on which jobs run (LES agents 
1 . .n) . 

Each LES Agent updates a local job repository 180 
that maintains jo^ information on^ each job submitted to 
10 . it's respective node;. The local job repositories are 
installed on each- node where jobs 1 run and may be 
implemented using SQL*Anywhere (a database product 
having a small footprint, for efficiency of resources) . 
.Other SQL products and, various database/repository 
15 configurations may be substituted. 

A central job repository 190 maintains a super set 
of job data on all jobs submitted to each node in the 
system. The central job repository is maintained by a 
job data management API 140, and is implemented in a 
20 Relational Database, Management System (RDBMS) , Dex, or 
other data repository or management system. 

The job data management API 140 selects, inserts, 
updates , or deletes j obs . and j ob histories . Both local 
and central job repositories are updated by job data 
25 management API. Also, the job data management API 140 
is used internally by the job scheduler and the LES 
agent. The job scheduling API reformats data into PEC 
message format. 

A location of the central job repository 190 is 
30 determined by RDEX (Relational Data Exchange) . If no 
DEX (Data Exchange) information is available, the SDM 
(Software Delivery Manager) install prompts are 
utilized for table location information. 
Configuration files for set up of the POEMS 
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environment, PEC 160, LES agents, etc, are maintained 
on a same node as the central job repository, each 
client machine, and on each node; where jobs run. 

Each of the Central and local job repositories are 
5 automatically updated by LES. The point products 
themselves only interact with the API's and are not 
concerned with the details of either type of 
repository. 

A point product API 150 is v provided to allow 
10 access by each point product to determine job status, 
job logf ile, perform setup and cancel functions (jobs) , 
update the job logf ile, and retrieve job parameters as 
the job runs. In the POEMS configuration, this API is 
utilized by the point product executable (point product 
15 100, for example). 

An LES command line 155 provides command line 
access to job administration functions (by 
communicating with a job administration API 150) , 
including determine job status, and setup, cancel, or 
20 update a job logf ile and retrieve job parameters. 

The job administration API 150 deletes; cancels, 
reruns, or copies existing jobs. This API is used 
internally by the LES command line 155 and a job folder 
. 18 5 - ( containing a list of jobs, that may be viewed in 
25 various formats) . 

Each of the point product API 120, Job Scheduling 
API 130, Job Data Management API 140, and Job 
Administration API 150, communicate as needed with any 
of LES agents installed on nodes 1. .n via PEC messages . 
30 The PEC messages are provided in a format to 

communicate between LES enabled workstations and the 
various APIs. 
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A calendaring API 165 is provided to manage 
calendar functions and is used internally by other 
API's and the point product GUI. 

The POEMS enabled point products and— LES agents 
5 installed on nodes of a computing network or system 
provide common job scheduling services > hereinafter 
ref erred to as . the Lightweight ^ Enterprise Scheduler 
(LES) . The LES allows a user to schedule a new job, 
delete a job, cancel a running job, and re -run a- job. 
10 A sample LES job flow is provided in the following 

' . StepS :; . * : \ V - 

li-,-: Enter job parameters ; in the point product 
GUI . 

2. Press the w Finish/OK" button. 
15 .3. Job parameters are, passed to the LES Job 

Distributor. 

4i Parent job g entry is placed in the central 
repository. 

5,. Job parameters are passed to the LES agent 
20 using PEC. 

6.. Job parameters are stored in the local Job 
Table. (If. this step fails, an event/alarm 
is sent indicating: . that the job is not 
scheduled on the node.) 
25 7. Child job is created and stored in the 

central repository. 

8. Repeat steps 5-7 for each of selected nodes. 

9. At the appropriate time, the job is started 

(which launches the point product 
30 executable). 

10. Job parameters are obtained from the job 
table using a. LES API. 

11. A job progress message is sent out. 
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12. The job's progress displays on the console 
using a progress monitor: 

13. The job completes, and the LES agent plaices 
a record in the local Job History-Table. 

5 14. The LES agent places a record in the central 

Job History Table. 
15. The LES Agent sends a "Job Complete" event. 

LES Agent 

10 Figure 2 is a block diagram illustrating the main 

components and communications of an LES agent (LES 
agent 170, for example) . The LES agent consists of 
three main parts: 

15 1- Communication Module 210 - Sends and receives 

PEC messages from the Job Distribution API to 
the point product and from the point product 
to the Job Distribution API. 

20 2 - Job Management Module 2210 - The LES kernel. 

This part of the agent sets up the internal 
environment and memory, launches the job, 
runs the job* and manages job processes. 

25 3 - Data Management Module 230 - Updates and 

deletes data from the Local and Central 
Repositories (180 and 190, respectively) . 

A low-level function API 240 is available to all agent 
30 modules. This low-level API handles all internal 
functions, file management, and messages. 

Figure 3 is a flow diagram illustrating how PEC 
messages are normally routed. A send module 300 sends 
a message 320 having a destination encoded therein 
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. which is received by an RT server which sends copies of 
the message 320a and 320b to each of i Receive modules 
340a. and 340b, respectively (LES agents ,; for, example) . 
. vTo prevent the RT server from delivering the same 
5 job message to more than one agent) the LES agent 
registers as PTLES__<nodeaddress>; datagroup. This 
registration identifies each LES agent with a unique 
-datagroup so that messages may be routed to nodes of a 
.datagroup corresponding to ;the message. 
10 f s Each LES Agent subscribes to- the current node 
address (hostname) messages, so each sender should also 
: specify ; which node will; receive , the message . Proper 
message routing is illustrated in Figure 4,. which 
illustrates the RT.- server 310 passing the -message 320 
15 , to Receiver module 345a,;. and Receive module 345b not 
receiving, a copy. An RT Server-runs on each machine 
where processes- are managed, providess PEG routing to a 
correct destination. 

-Figure, 5 is a flow diagram illustrating the flow 
20 of messages incoming to an LES agent 500.. All incoming 
messages are received via, a PEC communication API (PEC 
160, for example, see Figure 1), from any of a client 
process 520, point product agent 530, or other module 
- communicating with an LES agent. Each message is. 
25 routed via an RT server (510a, 510b, for example) to 
the LES agent 500. 

Figure 6 . illustrates reverse message traffic, from 
the LES agent 500 to the point product agent 530. The 
LES agent 500 sends point product parameters to the 
30 point product process (agent) 530 using PEC messages 
via the RT. server 510. 

Figure 7A is a flow chart illustrating the steps 
for LES agent startup. At step 705, LES configuration 
files (which maintain startup information oh location 
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of repositories, information for LES to find out how to 
set-up and operate) are loaded. At step 710, LES local 
job repository tables are created (local job repository 
1 180, see Fig. l, for example) . Step 710 ts bypassed 
5 if local job repositories are already present on the 
node which the LES agent is being started. 

At step 715, the. local job repository is 
synchronized with the central job repository 190. For 
example, The synchronization process updates the 

10 central job repository to reflect each entry in the 
local job repository, this process assures that the 
central j ob repository maintains records for each j ob 
across the enterprise. 

At step 720 , a history row is added for all 

15 expired jobs (both central and local) , Information on 
expired jobs is maintained for historical purposes. 

At step 725, PEG call back functions are 
initialized. The PEC callback functions provide the 
appropriate API interface allowing communication with 

20 the PEC 160. 

At step 730, a synchronization timeout is computed 
and setup. The synchronization timeout 

is utilized to control how long to wait to connect to 
: the other repository. 

25 As illustrated in Figure 7B, once the LES agent is 

started, it begins performing receipt and startup of 
job processes selected to be run on the node on which 
the LES is installed. At step 750, the LES agent 
computes and performs setup of a next job to run, and 

30 then enters a wait loop 760, where the LES aigent waits 
for one of a PEC message. Synchronization timeout, and 
a timeout on a next job to run. 

When the wait loop times out on a next job to run, 
step 770 is performed, which includes running the 
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current job (next job that timedout) , updating a start 
status of the job, and creating a run history row 
(updating and creating actions are performed in both 
local and central repositories) . — 

When the. loop times out on a synchronization, a 
Central /Local synchronization program is executed 

(synchronizes Local with central, and central with 
local) . * 

When the loop; receives, a PEC message, the LES 
agent :::perf orms the action contained in the PEC message, 
step 780 . PEG messages received by the LES agent 
include messages to run a job, cancel a job, update /job 
status, request j ob /parameters (Job parameters aire 
information that a product would need, user name, :db 
name,, set by. point product and stored in the; LES API in 
an area of the LES db where point products can use for 
whatever they want ) . 

Upon completion of either the job timeout, 
. synchronization timeout, or PEC message action (steps 

770, 790, and 780, respectively), the LES agent 

computes and sets up a next job to run ^repeating step 

750), and re-enters the wait loop 760. 

When the POEMS Scheduling Service is utilized to 

add a job, the point product GUI 110 calls the Job 

Scheduling API 130 to submit the job. 



1. „ Saves the job in the central repository. 

2. Checks to see if the agent is present. 

3. If the agent is running, sends a PEC message 
(including the job) to the agent. 



The API performs the following steps: 



The Agent performs the following steps: 
1. Receives the PEC message. 
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2. Saves the job in the local repository. ; 

3. Checks when to run the job. 

4. Launches the command line, v — 

5 The liES agent is maintained in an hierarchically 

organized directory structure, one example being 
illustrated in Figure 8. A top level directory 
$PLATHOME 800 contains all relevant directories 
containing files related to Platinum products (other 

10 products could alternatively be used) ^ ^ ; v A POEMS root 
directory, $ptroot 810 maintains, all ; directories and 
files related to enabling POEMS . 

A cfgref 830 directory maintains a configuration 
file configuration files 195 , for example . 1 

15 A shlib* 840 directory maintains all * -lib, and 

*. so files; which are shared libraries. 

A bin 850 directory separately maintains each of 
a ptles* files 852, *.dll 854, and *sql.dll 856 files. 
The ptles* files 852 include ptlesag , ptlestp, 

20 ptles tab, and other related files. The * . dll 854 
maintains each of dynamic link libraries, and *sql.* 
856 maintains LES queries for LES functions. 

A log 860 directory maintains a ptlesag. log 865 
logf ile (that includes a diagnostic log, info about 

25 runs, and errors) . 

In one embodiment, as illustrated in Figure 9, the 
Platinum Security Model requires that many 
applications /point products be run as a specific user 
in order to succeed. 

30 An AutoLogin API provides a way to run jobs as al6 

specific operating system user without querying the 
user at run- time or hard- coding the UNIX user as part 
of the job. 
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To take advantage of this feature, an application 
may utilize an PtLESSet JobCommand ( ) function and pass 
a username and role to I.ES. If the username and role 
are set to NULL, LES runs the job; as ^he default r 
5 platinum user (or other default-user). Otherwise LES 
tries to retrieve the userid and password;* by calling 
the AutoLogin API and passing the username and role as 
Requested User and Requested Role, the operating system 
as Resource Type, and the job instance name as Resource 
;10 Instance* 

Entering Login Information in AutoLogin 

■ In the AutoLogin embodiment > an administrator 
signs in as "root? to set up the LES/OS resources. 
15 From the POEMS Director: 

1. Select Tools ^Security Actoin^* AutoLogin. 

2. Log in as "root". If already logged in, 
"rtlogout .exe n may be utilized before running 
Administrator AutoLogin. 

20 3 . The AutoLogin Administration window displays. 

4. Right- click on the Agent's Requesting User 
folder to invoke a pop-up menu display. 

5. Select Add Entry. 

6. The Add Entry window displays. 

25 7. Enter login information in the fields. 

h) The Resource Type is set to OS. 

i) The Resource Instance is the same instance 
name that the point product passes to the 
job. 

30 
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If the Point Product . . . . * 

•Uses AutoLogin and a valid user ID and a password 
are recorded in the Add Entry window, the LES 
5 agent passes the ID and password strings and 

access is granted. 

•Uses AutoLogin but no user information is 
recorded in the Add Entry window, the LES agent 
10 automatically checks for the UNIX user login. If 

the UNIX user is found, access is granted. 

•Uses AutoLogin and an invalid user ID and 
password are recorded in the Add Entry window > the 
15 LES agent defaults to PLATINUM (or other default) 

user. 

•Does not use AutoLogin, the LBS agents defaults 
to the PLATINUM (or other default) user. 

20 

Command Line Interface 

The command line interface included in LES 
performs administrative functions, including: 

- Delete a job with all its runs. 
25 - Cancel a job's run. 

- List all jobs* 

- List all jobs by product code, status, and/or 

node . 

- Rerun a job immediately. 



30 



The command line interface utilizes the following 
format: 
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ptlescmd [-a action] I [-jobid] [-c.cleanupj)rpcess] 
[-r run_number] :[-p product_code] [-s status] [-b 
buf f ersizel , [-n node] 



10 



Note: The a option is for all actions; the -j 
option is for all actions, except List; the others are 
optional ♦ 

Ptlescmd is the LES command line interface used to 
deleter a . job, cancel a job run, list jobs (all jobs, by- 
product code, by status, and/or node), and rerun a job 
immediately. . r . 

. Table 1 provides 1 a listing of the ptlescmd command 
line supported options . 



15 





TABLE 1 




Command Line Options 
. and . Arguments 


If Omitted 


Description 


; >a [action] 


Errors v 


Executes a given action . 
-Action can have any of the 

following values: 

delete , cancel , list , 

rerun 


- j C jobid) 


Error (except 
with "list" 
action _ v : 


The job ID of the job to be 
acted on. In one 
embodiment, this is a 
required option (except with 
List action) . 


-c Icleanup^rocess] 




The name of the process to 
be executed after deleting a. 
job. If a delete action is 
specified and no cleanup 
process name. is given, then 
no cleanup will take place 
on UNIX after deleting the 
job. On NT this option will 
check the registry for an 
existing cleanup process and 
execute it after deleting 
the job. 



20 
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5 



Command Line Options 
and Arguments 


If Omitted 


Description 


-r [rur^jiumber] 


Error 


Tn onp ^mlSrif^ impnf t-Vi^ es 

number is required with 
Cancel action to define 
which run of the specified 
job will be generated. 


- p [product code ] 




ubcu uuiy wnen p rouu Ct COQ6 
is specified with List 
action, a list of all the 
jobs with this specific 
product code will be 
generated. ' 


-s [status] 




Used only When status i s 
specified with Lifet action, 
a list of all the jobs with 
this spiecif ic Status will be 
generated. 


-n [node] 




Used only when node is 
specified with List action, 
a list of all the jobs on 
this node will be generated. 


-b Ibuffersize] 


Default value 
is 1024 


This option is mainly needed 
when the user knows that the 
number of elements to be 
retrieved is large . 
(>100,000) , The default 
value is 1024 (ik) . 



I ^ . To use the LES ;cpirahaiid; line , a user; types the following: 
ptlescmd -a [action] -j [jobid] [-letter option_name] 
10 where: 

action is one of the following: delete, cancel, 
rerun, and list. 

15 jobid is the identifier used for the job. 

letter is the letter for one of the options listed 
in the Command Line Supported Options table. 
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option_name is the name of one of the options 
listed in the Command Line Supported Options table. 

Table 2 provides a set of example commaed lines and 
5 a corresponding description. 



TABLE 2 





Command Line 


Description 




ptlescmd -a delete 123 


Deletes job 123 and all its runs 






then runs the process cleanup.exe 




ptlescmd -a delete -j .134 


Deletes job 134 and all its runs 




ptlescmd -a list 


Lists all, jobs 




^ptlescmd; -a list -n 


Lists all. jobs on the node = 




dimultra ... 


*dimultra' ; 


15 


ptlescmd -a list -p TSR 


Lists all jobs with the product 
code = 'TSR' 




ptlescmd -a list -s running 


Lists all jobs and their running 
runs ^ 




ptlescmd -a list -p TSR 


Lists all jobs of product code = 




-s completed 


*TSR' and their completed runs 




ptiescmd -a cancel -j 234 


Canceis run 3 of job 234 


20 


-r 3 






ptlescmd -a rerun -j 345 


Reruns job 345 immediately 



Kote; Valid . status values include ; Completed, Failed, Notstarted, 
Preempted, Running and Stopped. 

25 

LES jobs stay in the central and local repositories 
until the user deletes them; The user can delete, 
rerun, or cancel a running job at any time by right - 
clicking on the Poems director/Job folder 185 and 
3 0 selecting the appropriate option. A delete option 
removes the job and all the runs and history of the job. 
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The point product may provide a cleanup process 
executable that remoyes all the point product files 
related to the job. This executable, if available, is 
run by the agent - bef ore removing the job and job 
5 history* , 

LES provides job modification options incruding 
Renin Job and Update Job . : t The Rerun Job option allows 
a user to rerun the j pb wi th a different start time. 
A PtLESUj>date Job ( ) fuhctibn allows updates for £11 GUI 
10 fields. " 

Context variables > such as %C (PLATHOME) or the 
environment variable %E ( FUS^HOiyiE) etc., Which; are 
resolved by the agentf bef^rp running the job boinrtiand . 

The UNIX username is set from the GUI point product 
15 as ....Part of the jobi The agent does not need the 
password because the agent is running as root (the agent 
has the set root ID bit) . 



20 



Context Variables 

Context variables are keyword identifiers that may 
be used on the command line. The LES agent converts 
these variableis according to the context of the current 
job and job parameters passed. The LES agent inserts 
-these context variables, forms the command line, and 
25 then executes the command line. 

•Keyword Context Variable - Substitution takes 
place from the current jpb. 

•Environment Variable - Substitution takes place 
30 from the environment where the agent is running. 

•Filename Variable - The agent uses this variable 
as the filename and replaces it with the contents 
of the file pointed to by the variable. 
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How Context Variables Are Specified : 
Keyword Context Variable: 

Specified as %C (context identifier is replaced by 
value) -e.g., my_prog %C(JOB_ID) ^C(USERNAME) 
5 ■ replaced with my_prog 1234 manager wheire the 

current Job jobid = 1234 and username = manager. 

Environment Variable: 

Specified as %E(variable name) - e.g., my_prog 
10 %E (HOME) %E(LANG) , my^rog/home/platinvim.-enrus . 

. Filename Variable: 

Specified as %F (filename) - e.g., my^prog 
%F ( /etc/platinum) %C ( jOB_ID) %E (HOME) my_prog 

15 /home/dinc 1234 /home/platinum where the filename 

/etc/platinum contains the line /hbme/dmc. 

Acceptable %C( context variable name) syntax key words: 
The syntax for the variables is %C (KEYWORD) "... A user may 
20 insert a space on either side of the KEYWORD inside the 
parentheses. Table 3 provides a listing of sample 
keyword identifiers. 

'•' TABLE 3 



/* Identifier 


Value 


Description 

•■ • ■• */• ■ 


/* JOB_ID-Env 


_JobRecord . j oid 


Job ID 

*/ 


/* GROUP_ID-Bnv 


_JobRecord . group id 


Group 

*/ 


/* HOSTNAME 


JobRecord . node 


Hostname 

*/ 


/* INSTANCE- En v 


— JobRecord . instance 


Instance name 
*/ 


/* USERNAME 


_JobRecord . username 


User name 

*/ 
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5 



10 



/* OWNER 


_JobRe cord. owner ■ . ■* 


Owner 

*/ 


/* PASSWORD-Env 


_JobRe cord, password 


Password 
— */ 


/ * CpNNEOT^STR 


_ JobRe cord . eonne c t s t r ing 


ConnectStrin 
*/ 


/* JOB_OWNER 


_JobRecord . j obowner 


JobOwner 


/* OBJECT 


_JobRecord . ob j ect 


Object name 

•. - :i ■ ■ */ 


/ * PRODUCT CODE 


_JobRe cord . product code 


Product Code 


/* PRODUCT VERSION 


_JobRecord .productversioh 


Product Version 


/♦DESCRIPTION; 


_JobRecord . description 


Description 


/* EM2VIIj_ADDR 


_JobRecord ^notification 
email 


E mail Address 
*/ 


* TYPE 


_ JobRecord . type 


Type 

- - ■ ■*/■■ ■ 


/* C_SCRIPT 


_JobRecord . completion 
script 


Completion 
script */ 


/* F_SCRIPT 


_*JobRecord . f ailedscript 


Failed script 
.*/ 


/* PIATHOME 


^Installation directory 


Install dir 
V 


/ * X7SERROLE - Env 


_ J obRe cord .use r rol e 


User role 

*/■- 



GUI API 

The GUI API is utilized by the point product 100 
20 and the point product GUI 110 for a number of functions, 
including: 

•Allocate a job with the Job Scheduling API and 
override any default values as desired. 
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•Base a GUI on class CptDynPropertySheet (which is 
derived from CpropertySheet) , instead of using 
CpropertySheet directly. CptDynPropertySheet is 
exported by DnyPS.DLL In addition, ^fche GUI API 
5 may be used to submit a job without ever 

displaying the GUI window. 

•Use the GUI API to construct a 
... (^tLESJobSch^daiin§i?age (see Fig. 25, for 

10 example) object based 6n the job, and then add it 

(and any other pages) to. the CptDynPropertySheet 
or CpropertySheet ^-derived- property sheet . 

•Use the GUI API 1 1 6^ customize any job parameters 
15 that are displayed on the scheduling property 

page. 

•Use the Job Scheduling API to set any required job 
parameters that cannot be set by controls on the 
20 ' scheduling property page. Examples of these 

include point product -specific; job parameters set 
by calling PtLESSetJobParm. 

•When a final OK indicates that the job should be. 
25 submitted, use the GUI API to validate the data 

and submit the job. 

Products that use the LES Job Scheduling page as a tab 
call its ValidateData () method before submitting the 
30 job, ValidateData () can be safely called multiple times 
and can be called in such a way that no message box 
appears to the user. 

Table 4 provides sample code for invoking the GUI 
API to implement to the above discussed processes . 
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Step 


Sample Code 


Allocate a job and 
override defaults 


PtLESJobHandle job = Ptl^ESJobAlloc () ; 
PtliESSetiJobTZNode (job, PTLESjrZIOCAIi) ; 


Setup property- 
sheet and pages 


CpropertySheet sheet ; 
CptLES JobSchedulingPage LKSpage 
(CptLESJobSchedulingPage : :AsPage, job) ; 
Sheet .AddPage (IiESpage) ; 


Set product job 
info 


PtliESSetJobParam (job, key, value) ; 


Customize the 
page • s data 


LESpage -. SetRunWhen (CPtliESJpbSchedulingPa 
ge : : Runlmmediately) ; 

LESpage . SetRunWhenState (CPtLES JobSchedul 
ingPage :: Disable) ; ,- 


When the sheet 
exits, validate the 
data, and submit 
the job 


In the sheet's OK handler: 
if <LESpage . ValidateData < ) ) 

sheet .m_XESPage - 
>Submit Job ( "nodename " , groupIDy TRUE) . 



Job; Distribution API 

The job distribution API dispatches information to 
appropriate machines <LES workstations) , typically 
called by the job data management API 140. 

Job Scheduling API 

The job scheduling API 130 works with the point product 
GUI to define submitted jobs. Some of the functions 
available via the job scheduling API are required, some 
are optional, and some are internal functions that can 
be set by the user through the LES GUI. A value is set 
for baseline functions and any desired optional 
functions or functions that are defined by the GUI 
(defined as appropriate for a corresponding point 



15 



20 



25 
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product) . 

The following tables list . functions by type and 
provide a brief description of each function. The 
baseline functions are utilized to provide basic 
5 information for the job scheduling processes, and are 
listed with a description in Table 5. 



TABLE 5 - Baseline Functions 



Function 


Description 


User Name 

- • •- 


:User name under which ; to run the job. In 
one' embodiment, the scheduler must be run as 

: root in order to use this function. If it 
is run as retot -and the User Name field is 
null , the scheduler: .will automatically mark 

: the. j pb as- f ailed . 


Node 


Indexed on central table. Specifies the 
node used to run this job . 


Command 


The command line 1 to execute . Because of 
database VARCHAR siie; limitations, this may- 
be split into : 2* pieces by the API and 
reassembled to invoke r. 


Product Code 


Code identifier of the product used to 
create the job. This should be the code 
assigned and used by the PLATINUM PAR 
tracking system. 


Product Version 


Version number of the product used to create 
the job. 



15 

The optional functions, listed and described in 
Table 6, are not required and are utilized (defined) as 
appropriate for a specific point product. 

20 
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TABLE 6 - Optional Functions 



5 



Function 


Description 


Group ID 


Strategy group ID 

Use the function PtliESCreateGroup to get 
the Groupid . 


ReTrylnterval 


After a preempted run, this is the number 
of minutes to wait before attempting to 
rerun the job. If zero, the job will not 
be rerun af ter be ing' preempted. ' " 
A preempted run is a job that did hot run 
because the. point product determined that 
it should npt run due to point product 
speci f ic opera ting rul es . 


RetryCount 


Number.of retry attempts to make if the 
job was preempted or was unable to start. 
If zero, the job will not be rerun after 
preemption or start failure. This does 
not control reruns after a point product 
.failure ...... • • , 


N r e . t r ,y s 
( Re cur Fa i IThre shol 
d > 


Number, .of failed (point product) runs to 
accept before the job is no longer 
rescheduled. This value is moved to 
, n Rec^lrFailureCount l, upon job creation and; 
every time the job runs successfully. 
This field helps control runaway job 
rescheduling for jobs that never run 
correctly. 

See "RecurFailureCount" for more 
in forma ti on . 
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Re cur Fa i 1 Count 


This function counts job failure. for a 
given number of successive runs. It is 
decremented each time the job fails and 
reset to its original value 

(RecurFailureThreshold) each time a job is 
enr«r*oecfiii T-F t*H*=» valup ever sets to 
zero, the job will not be rescheduled. 


Instance 


vaLouaSc IUdLcuilc -J- a^axuou . 

Optional., for database ^related point 
products. 


Owner- 


Optional user ID for. point product use 
(For RDBMS product, this would be the 
owner _ ) 


Credjvalue 


Optional user password. 

Encrypted/decrypted by API set and get. 


Conne c t S t r ing 


Optional database connect string or name. 


JobOwner 


For future use related to security (Only 
the owner of the job can make changes.) 


Object 


Optional object name for point product 
use . 



Table 7 lists internal functions that may be set 
10 by a user via the LES GUI . 



4 
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TABLE 7 - GUI Functions 



Function 


Description 


Jobld 


Unique job ID. Each unique ID is^ generated 
on the central control server. The IDs are 
unique within the nodes managed by that 
central server . 

Use the function PtLES Submit Job to set the 
JoblD. The Job ID cannot be zero. 


Next__Start 


Indexed on local node » This is the next i 
time, in GMT, to run this job. Time t 
timestamp is set using the calendar and, 
recurrence information the next time the 
job is started. If = -i, this job is to be 
run immediately. 


Time Zone 


l=sUse time zone of the node where the Job 
will run. 

2=rUse time zone of the node from which the 
job is scheduled (local workstation's time 
zone) . 

This value from Window 1 s time zone 
tonveiiLion snouiu oe converted to whatever 
time zone convention LES uses. This 
function is used to convert the time to 
GMT. The API will retrieve the time zone's 
offset from GMT and adjust the time to GMT. 


WSTimeZone 


Time zone of the workstation from which 
this job is scheduled. This is used by the 
scheduler to adjust the time if 
TimeZoneNode = 2 . 


Notif icationEmail 


Email address where job completion 
notification will be sent. 


CompletionScript 


Script to run upon successful completion. 


FailedScript 


Script to run upon failure. 
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Description 


Optional job description. 


Cal endar Id 


tfi nf Vhp Calendar to use. 


Recurlnterval 

• . '• ' - 


This is used to test if the job^ fails for a 
given number of successive runs. It is 
/^onroTnonhP^ ^arh time the "iob fails and is 
reset to its original value 
(RecurFailureThreshold) each time a job is 
successful. When the value equals zero/ 
the job will not be rescheduled. 


Re cur increment 


How often to run the job, depending oh 
recurrence interval ; "Every x minutes; ' 
every x days , every x months , etc . " 


. Every Weekday 


fPVk-Ie? Tan - ct^AhAC +*0 Y~I1T1 1 PV6TV' dav Of 'the 

week (Recurlnterval = Daily) . . ^if triis is. 
set and Recurlnterval = Daily, 
Recurlncrement is ignored. 


Day s__of _We ek 
(DayOfWeekFlags) 


Zero padded array. Flags to indicate which 
day or days of the week to run the 
job(0=Sun'day, 6=Saturday) (Recurlnterval = 
weekly) 


DayOfMonthFlags 


Zero padded array. Flag to indicate wbich 
day or days of the month to run the job (i 
to 31) ( Re oar Interval = Monthly) 
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LastDayOf Month 


If true, run on the last day of .the 
month (s) (Re cur Interval = Monthly or ; 
Yearly). The job will run on the last day 
of the month regardless of which actual day 
the end of the month falls on (28, 29, 30, 
or 31) . Can be used with or without the 
DavOf MonthFlaas If npf t-h-i « i-»v>ao 
precedence over the DayOfMonthFlags (i.e., 
the job flag for November 30 is off and 
this is on, the job' will run oh November ' 
30) . " i 


YearMonth 


Month to run (1-12) for yearly interval 
(Recurlnterval = Yearly) 


TimeOfDayHour 


Hour of day ( 0 - 23 ) to run 


TimeOfDayMinute 


Minute of hour (0-59) to run 


o uclx c i. xmes 


Minutes after each hour flags. Zero-padded 
flags - one for each minute of the hour. 
This is used, to emulate Autosys' run at x 
minutes after each hour behavior. Each 
flag, when oh, signifies the job should run 
at that minute after EVERY hour after the 
first run which is determined by 
next_start. 



Table 8 provides example code for on how the GUI 
API 115 would be utilized by a point product. For 
example, allocating a job structure requires a point 
product to define a handle ( jh) , an array defining the 
days the job is to run (0=don't run, 1 = run; ie, 
0,0,0,0,0,1,0 means run on Friday), a userid and 
password, and a call to the PtLES Job Alloc ( ) function. 
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TABLE 8 



Step 


Sample Code 


Comment 


Allocate a 
job 

.structure 


PtLBSOTobHandle jh; 

int day s_jt o_run [ ] = 

{0,0,0,0,0,1,0) ; 
char userid[20] , 

password [20] ; 
jh=PtIiESJobAlloc () ; 


run on Friday 


Set 

parameters 
for the 
job 


PtLESSetJobDescription (jh, "smith" , . 
"TablespaceReorg" , "Weekly run"); 
PtLESSetJobCommand (jh # "reorg.exe") ; 
PtLESSetJobProdlnfo (jh, "Tsreorg" , 
"2 .07") ; 

PtliESSet Joblnstancelnf o ( jh, "ora73 n , 
userid, password, "payrl .world" ) ; 
Ptl-ESSet jobObject (jh, "payroll") ; 
PtLBSSetJobRetry ( jh, 10, 6) ; 
PtI*ESSetJobTZNode ( jh, PIljES_TZIiOCAIi) ; 
PtLESSet JobRunRules (jh, 
PTLES_RECURWEEKS , 1, 0 day s_t o_run , 
NUXiIj , NULiLi 0 , 0, 0, 22 , 0) ; 


Retry every 
10 min for an 
hour every 
week at 10pm 


Submit the 
job on two 
nodes 


PtLESSubmitJob (jh, "dimultra" , 101 , 0) ; 
PtLESSubmitJob { jh, "dimsparc" , 101 , 1) 


node dimultra 
node dimsparc 


Clean up 


Ptl^ESJobDealloc (jh) 





15 Calendar ing API 

The calendaring API is utilized internally by other 
APIs and provides comprehensive calendaring functions. 
For example, main use of the Calendaring API is to allow 
users to input calendaring information for a specific 

20 job ruii. 
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Job Administration API 

As discussed above, the job administration API 150 
deletes , cancels , reruns'*- or copies existing jobs. in 
addition, it allows other APIs to determine -Job status, 
5 and setup, cancel, or update a job logfile and retrieve 
job parameters. For example, one process within the Job 
Administration API is the PtLESCancel Job utilized to 
stop currently running jobs* The PtLESCancel Job first 
performs a cheek on a specified node to see if the jbb 
10 is running, and issues a stop cornrnand to the 
corresponding LES agent if the job is executing. 

job Data Management API 

Both the job and the job history are saved in the 
15 central repository and the local repository of the node 
where the job is to be run. Open Database Connectivity 
(ODBC) is used to select, insert, update, and/or delete 
each job or job history. 

20 Point Product API 

The Point Product API allows the point product to 
communicate with the LES Agent. When you use this API, 
the LES job folder shows more accurate information about 
-your job, the logfile viewer shows the job logfile, and 

25 the LES agent manages your point product job, making LES 
easier to use from a development standpoint. 

The functions of this API encapsulate PEC messages 
to the LES agent to update the job status or logfile, 
or signal the end of a running job process. The PEC 

3 0 model is adhered- to wherein the LES agent and the point 
product are Rtclients using broadcast communication. 
PEC Initialization has been performed before calling any 
of the LES_API functions. In addition, the Point 
Product should call TptTerm before exiting. 
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In one embodiment, SIGUSR2 is used as a CANCEL 
notification signal on all UNIX platforms, and the LES 
agent ignores this signal by default. Because the child 
process inherits ~~all signals, thef GANCEE ; event; is 
5 ignored unless— the poinfe product takes action; 1 As a 
result, conflicts may arise if '/a. user application is 
using SIGUSR2 for other purposes (but allows for 
utiliation of standard UNIX toolsets for operations) . 

The following Environment variables are set before 
10 running, any .point product by the LES Agent: 

LES^JOBID~tThe point product , current j oh number 
LES_RUN_NUM — *The Point product . current .run number 
LES_GR6uPID-tThe point . 'product current strategy 
group number 

15 LESJRUNTIME-*The schedule time (If - 1 , the job was 

scheduled to run immediately.) 
LES_INSTANCE-*The job instance 
LE S__US ERNAME - * The job user name 
LES_USERROLE~~ ^The job user role 

20 ' 

Error messages are displayed whenever the; agent 
detects an error. Table 9 lists the errors , consisting 
of a number and a message. Some of the messages use 
variables, which appear as % signs in the message text 

25 as shown in the following example. These variables are 
replaced by actual values when the error message 
displays. For example, in this case the variable % is 
replaced with the actual constraint and file name when 
the error message is displayed. 



30 
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5 



10 



15 



PTLE S_AGENT -0001 


Agent is already running 


PTLES AGENT-0002 


Cannot get the current node name 


PTLE S_AGENT- 0003 


Cannot open process table file 


PTLES_A(3ENT-0004 


Cannot write to process table 


PTLES^AGENT- 0005 


Cannot read from process table 


PTLES_AGENT- 0006 


Cannot, allocate enough; memory, for the job 
handle u. : , 


PTLES_AGENT - 0 0 0 7 


Unable to free the job handle memory : 


PTIiES^AGENT- 0008 


Unable to find the job attached to this 
process id (%d) ..,v ,~ . 


PTLES__AGENT - 0 0 09 


Unable to read job parameters 


PTLES_AGENT - 0 0 1 0 


Cannot allocate enough memory for the 
calendar handle 


PTLE S_AGENT - 0 0 1 3 


Cannot create a PEC message (TipcMtCreate 
failed %d) 


PTLES_AGENT- 0 0 14 


Unable to find and cancel the job with 
j 6b_i d= %d arid run i numbel r =% d 


PTLE S_AGENT - 0 0 1 5 


The following is not a valid job, cannot 
cancel this job. (job_id=%d, run number 

= %d) . , . 


PTLE S_AGENT - 0 0 1 6 


Cannot cancel the following job (job id = 
%d, run number = %d) system error = %d 


PTLES_AGENT - 0 0 1 8 


Cannot execute job process - job_id = %d 
and system error is: %d 


PTLES_AGENT - 0 0 2 0 


Cannot execute job process - job_id = %d, 
the user (%s) doesn't exist 


PTLES_AGENT- 002 1 


Cannot delete the job - jbb_id = %Id, 
error = %d 


PTLE S_AGENT - 0 0 2 3 


PEC Callback create failed. (pec_error = 
%d> 
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PTLES_AGENT- 0024 


Cannot insert the job ( job_id = %d) into 
the Local repository error = %d 


PTLES_AGBNT- 0025 


Cannot insert a job history, job_id = %d, 
error = %d. Agent initialization . ... 
Checking the expired jobs: %s 


PTLES_AGENT- 002 7 


Cannot connect to the central repository. 
(ODBC-Error = %d) : - . 


PTLE S_AGENT - 0 0 2 8 


Cannot connect to the local repository. 
(ODBC-Error = %d) : •■\^.«:>-* 


PTIJ2 S_AGENT - 0029 


Calendar insertion error (ODBC -Error = %d) 


PTLE S_AGENT - 0 0 3 0 


Cannot update job (%d) (ODBC-Error %d) 


PTLBS AGENT-45 


"'the'" -"agent is not running 



Table 10 provides example source code- f or a point 
10 product job template and may be considered ah example 
use of the point product API 12 0, However, the code 
presented is not intended to be- either a conrp liable or 
executable version of the present invention or a 
complete embodiment thereof , but merely an example 
15 representation of some of the features discussed herein. 

TABLE 10 

/* Platinum Technology Inc 

* Copyright (C) 1997 Platinum technology bimeric Lab 
20 * All Rights Reserved. 

* PLATINUM Lightweight Enterprise Scheduler example program 

* using the LES Point Product API referred to LES — API 

* Function source code. 
*/ 

25 

/* Point Product job template and use of the Point Product API */ 



/* system includes */ 
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# include <stdio.h> 
# include <stdlib.h> 

/* pec include files */ — 
5 # include <rtworks/ipc.h> 

# in elude <ptm/ptm.h> ■ 

/* LES^API include files */ 
# include "ptles_s£ze .h* 
10 - #include ■ptles_ppapi.h* : ^ * 

/* edit keys here */ ; .. ; + v . ., 

/* for example purposes the num of keys allowed is limited tp 10 

'"*/ " ' ;: ' : 7 - :: ' :: . l -- - : - . : 

15 #def ine MKZJKEXS 10 

static char keys [MAX^KEYS ] IKE Y^_v£+ 13 ■ 

^7 ^"^ /* e.g replace "key 1" with your key value */: 

key 2-, : . r ... ,.. .. . 

20 -key 3-, : . 
key 4", : 



25 #define MY_STATUS_RUKMIHG 1 

#define MY_STATUS_COMPI*ETE 2 

#define MY_STATUS_ABORT 3 

# define MY_STATUS_CANCELED 4 

30 FILE *fplog; 

/* 

** If user want to cancel this job 
** switch to the following function 
35 */ 
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void 

cancelthisjob ( sig ) 
int sig; 

{ - - : 

5 ■ --. 

fprintf (fplog, "Update Job Status to STATUS_CANCEI.EI) -'\ii-)> 
if ( PtliESTJpdateJobStatUS ( MYSTATUSCANCELED ) ==LESAPI_FAIIi 

) 

{ • ' ' * • 

10 fprintf (fplog, "PtLESUpdateJobStatuss -Error %d\n") ; 

> ... ' • ~ • ■ ■ ■ ■■ ■ • ' r 

fprintf (fplog, "Point Product example : Job canceled by user 

• ^*e'ques.t\n i-V- : " ; - • ■" ■ 

P tltESUip da teExit Status (PP_F AILED) ; 

15 TptTermO ; 

f close ( fplog) > 
exit(l) s 

} 

20 /* example program demonstrates how a point product */ 

/* can use the XES^API to communicate with the I*ES Agent*/ 

int main ( argc, argv ) 

int argc; - 

char **argv; -. 

25 { • • . 

int rc; /* used for error return */ 

char pvalue [DATA_I»+1] ; /* allocation to hold value of a key-value 
pair*/ 

int plen; - /* length of value */ 

30 int ii /* used as a counter */ 

int num_i tarns;. . /* num of key- value pairs rec */ 

char *plat_home; 

char log_path [PATH_L+1] ; 

char *les_jobid , *job_id; 
35 char *les_groupid; 
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char *le s_runtime ; 
char * 1 e s_run_jaumber ; 

#if defined (DEBUG) && defined (WIN32) 
5 DebugBreak ( ) ; 

#endif : 



job_id - getenv("I,ES_JOBID") ; 
10 plat__home - getenv ( -PLATHQME" ) y 

if ( plat_home !« NULL && job_id !« NULL ) 

sprintf (log_path, -%s/les/ files/ logdir/pplogf iie^s .lc^- r plat^home, 
jobJLd) ; . : ■ - 

15 else 

strcpy (log__path, "pplogfile.log") j 
fplog o fopen( log_path, "w") ; 
if ( fplog NULL ) 

fplog m stderr? 

20 . , 

f printf t f plog, ■ - - — '- - - - - - point product example - - 

\n-); 

les_jobid = getenv ("LES_JOBXD") ; 

les_groupid o getenv ("LES^GROTJPID*) ; " 
25 les_runtime - getenv( "LES^RUNTIME") ; 

/* 

** LES VI. 1.0 New Env. 
*/ 

les_run_nximber « getenv ( "LES_RUN_ NUMBER") 7 

30 

fprintf {fplog, "ENV. VARIABLE SETUP BY PTLES_AGENT i \n") ? 
if ( les_jobid !* NULL ) 

{ - - 

PtLESSetJobld (atoi (les_jobid) ) ; 
35 f printf (fplog,-... . LES_tfOBID « %s \n", les_jobid) ; 
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} 7 
if ( les_groupid I- NULL ) 

{ 

. fprintf (fplog, LES^GROUPID «-%s \h"V^ies__grt>upid) ; 

5 - } ■ - ' 

if ( les_ runtime l« NULL ) 

fprintf (fplog, ■ . LE S RUNTIME « %s \n" , les_runtime) ; 

if ( le s_run_numb er ! « : NULL ) : 

fprintf (fplog, ■ LES_RUN_NUMBER = %s \n", 

10 les — run^nunber) ; 

/* print our any arguments passed on the command line */ 
fprintf (fplog, "Command line argument : : \n") ; 
for ( i-lji < argc;i++) 
15 { 

fprintf (fplog, "Argument [%d] : %s\n" , i, argv[i] ) ; 

} 

/* To use the LES_API you always have to call the PEC Tptlnit 
20 function*/ 

/* to make a connection to the RtServer in main program */ 

Tptlnit (PPROD__API, -VI. 1 ,0") ; 

25 /* LES VI. 1.0 adapt. Add CANCEL Function */ 

PtLESSetJobCanceK &cancel_thi s_ j ob ); 

fprintf (fplog, "Update logfile name : %s \n" , log__path) ; 
/* Communicate the Point Products Logfile to LES Agent */ 
30 if ( PtLESUpdateLogFileName (log_path)~«LESAPI_FAIL ) 

{ 

fprintf (fplog, "PtLESUpdateLogFileName: Error %d\n") ; 

> 

35 /* Update the Point Product Status to Running */ 
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/* use this function to update status */- 



fprintf (fplog # »Dpdate ,Job Status to STATUS_.RUNWING \n-) ; 
if ( PtLESUpdateJobStatus { MY_STATUSRUNNING) ==LESAPI_FAIL 

A ■ ■ - 

fprintf (fplog, -PtLESUpdateJobStatus x Error %d\n«) ; 



/* The following function call performs the Initial 
communication */ 

/* with the LES AGENT v */ 

/* Used to retrieve the point product parms that may be 
15 needed to */ 

/* be passed 
*/ 

/* stored internally is the jbbid and run number 
*/ 



f f lush i f pldg) ; 



fprintf (fplog, "Get Point product Parameters: \n") ; 
^c=PtLESGetProductParms( 360 /* TIMEOUT */ ) y 
25 if ( rc LESAPI^FAIL ) 

{ ■ . 

fprintf (fplog, "PtLESGet Product Parms : Error %d\n" , 
PtLESGetErrhoi) ) ; 



30 



/* Another call to communicate the progress of a job 



*/ 



/* to the LES AGENT */ 
fprintf (fplog, "pp — example : update the STATUS to 
MY_STATUS_ABORT « %d \n", MY STATUS_ABORT) ; 
3 5 if ( PtLESUpdateJobStatus ( 
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MY_STATUS_ABORT) «LESAPI_FAII# ) - - : - - 

{ 

fprintf (fplog, "PtLESUpdateJobStatus : . Error 
%d\n») ; — 

.5 • > 

/* Communicate exit status of point product */ 

/* pre defined to PP^STTCCESS, PP^FAIIjED, PP_PREMPTED */ 

fprintf (fplog, *pp_example : Update the exit status « 
%d \n", P P_FAH*ED ) ; : 
10 PtI*ESUpdateExitStatus (PP__FAIIiED) ; 

■ PtfcESDestroyParms () j 

TptTermO ; 

f close (fplog); 

exit (1) ; 

15 } 



/* edit the keys static char string defined before" the main 
* to. add point product keys 
20 */ 

/* return the- no of key value pairs */ 
num_i terns «=PtI*ESGetNumParms () ; 
if( num_itexns===LESAPI_FAIL > 

25 fprintf (fplog, - PtI«ES(^t^umParm3 : :$d\ri» , 

PtLESGetErrno ( ) ) ; 

> 

fprintf (fplog, "No. Parameters received: %d\n" ,num_i terns) ; 
num_i terns « num_i t ems <MAX_KEYS ? num_i terns : MAX_KEYS ; 
30 . fprintf (fplog, "No. Parameters received : %d\n * ,num_i terns ) ; 

/* retrieve an print the key value pairs */ 
for(i-0; i < num_i terns; i++) 

{. 

35 /* get the length of value in the key-value pair */ 
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plen« PtLESGetParameterLen (keys [i] ) ; 
if ( plen > 0 > 

> { ■ . , / ..... - 

/* Function used to retrieve the value given*/ 
5 /* a key for the parameter */ 

i f (PtliESQetParame ter (keys [ i ] , pvalue , plen) « = 
LESAPI_FAIL) ; , r 

fprintf (fplog, "PtLESGet Parameter: %d\n", 
10 P tLESGe tErxno ( ) ) j cU 

else /* print out the key -.value pair */ 
fprintf (fplog, 

■ \ tParame ter [%d] : k^y«%s Value «=%s 

len«%d\n", 

15 i,keys [i] , pvalue, plen) ; 

> 

/* print out the job Id and the Run Number received */ 
20 fprintf (fplog, "Received Job Id: %ld\n" , P tLESGe tJobldO ) ; 

fprintf ( f p-1 o g , * R e c e i v e d Job Run 

Number :%ld\n" , P tLESGe tJobRunNum () ) ; 

/* Another call to communicate the progress of a j;ob */ 
25 /* to the LES AGENT */ 

fprintf (fplog, "Update Job Status to STATtXS_COMPI,ETED \n") ; 
if ( PtLESUpdateJobStatus ( MY_STATUS_COMPIjETE) -»I*ESAPI_FAIIi 

) 

{ ■■ 

V 

30 ^ fprintf (fplog, "PtLESUpdateJobStatus: Error %d\n") ; 

} 

/* Before terminating call PtLESExit Status */ 
/* Communicate exit status of point product */ 
/* pre defined to PP_SOCCESS, PP_FAILED, PP_PREMPTED */ 
35 /* free the internal structures allocated by IiES_API*/ 
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fprintf (fplog, -Send EOT_0^_JOB with STATUS SUCCESS to 
. PTXiES__AGENT \n" ) ; 

PtLESUpdateExitStatus <PP_SUCCESS) ; 

PtliESDestroyParms () ; ,?r ~ 
5 /* terminate connection to RTServer */ 

TptTermO ; 

f close (fplog) ; ; " 

return (0) ? 

, }/» eof; of main */ ;: - . * / 

10 

Scheduling via POEMS , ; — 

The present invention has been. implemented 
utilizing a GUI interface that includes either a window 
15 (POEMS Scheduling Service Job Scheduling Window, Figure 
10) or a property page (Job Scheduling tab property 
page. Figure 11) . Other embodiments or arrangements of 
GUI windows or pages are also applicable, for example, 
using pull down selection menus instead of radio 
20 buttons, as just one example). 

The GUI interface allows user input for scheduling 
specifications for a job to be submitted, including: 
Immediate job run. 

- Job run at a later time. - 

25 - Starting time and date of the job. 

- Recurring run intervals for the job. 

- Create or select a scheduling calendar . : 

In addition, the GUI interface allows a user define or 
modify a notification script. 
30 To start a job, a user enters a job description in 

the Job Description box, selects a run time as either 
immediate, a later time, or start date and time, and 
then Clicks on OK or Finish. 

POEMS has several features for providing the 
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appropriate start date and time. For example, as shown 
in Figure 12 a pull down calendar is provided for date 
selection. The pull down calendar includes advance and 
decrease buttons as follows: . - ~T 

5 -Select the >> button to advance the year by one. 

•Select the « button to decrease the year by one. 
•Select the > button to advance to the next 
month . i 

•Select the < button to move back to the previous 
10 month. 

Since the POEMS scheduling service schedules jobs 
at remote nodes, a selection box is provided to use the 
local time of the remote node as the starting time 
15 (instead of the submitting node). 

Recurring job runs may be set for a wide array of 
intervals, including: 

•None - Used to schedule ho recurring runs for the 
job. 

20 'Minutes after each hour - Used to schedule 

recurring runs for a job each hour at a specified 
number of minutes after the hour. 

•Hours - Used to schedule recurring runs for a job 
at specified hourly intervals. 
25 •Days - Used to schedule recurring runs for a job 

at intervals specified in days or every weekday. 
•Weeks - Used to schedule recurring runs for a job 
at intervals specified in weeks on the selected 
day or days. 

30 'Months - Used to schedule recurring runs for a 

job at intervals specified in months on the 
selected day or days. 

• Years - Used to schedule recurring runs for a job 
every year on the specified dates. 
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Figure 13 provides an example of a job scheduled 
to run at selected minutes af tk • each hour (schedule 
the hourly recurring run interval) Figure -3r4 provides 
an example of a job scheduled to run every hour 
(schedule the recurring run interval in hours) ; Figure 
15 provides an example of a job scheduled to run every 
day (schedule the recurring^ run interval iii days). 
Figure 16 provides an example of a job scheduled to run 
every week on Thursday with a specific start date 
(schedule the recurring run 1 inteirval in. weeks)/. 
Figure 17 provides an example of a j^ob scheduled to run 
every 25th day of the month (schedule : recurring, run 
interval in months) . Figure 18 provides an. .example of 
a job scheduled to run once a year on June 25 th 
(schedule the recurring run intp^al in years).. . 

Notification Scripts 

As discussed above, the GUI interface provides the 

20 user an opportunity to definfe/ r modify, or select a 
notification script. Notification scripts are. shell 
scripts containing actions used to autdmatiicaiiy 
provide notification about jobs and .job status 
- information. Other functions may also be performed by 

25 the notification scripts, for example, The point 
product application executes the jobs notification 
scripts. The product application documentation should 
include detailed information on actions taken up° n j° b 
completion or job failure. 

30 Notification scripts may be constructed for 

tables, tablespaces, and indexes. When constructing a 
notification script for notification bf a completed or 
failed job, variables of previously assigiied values may 
be utilized. 
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The values for these variables are the same ones 
defined for a particular job in the default 
notification script files. A user may define the 
values for the variables in these files, and then use 
the variables in the notification script as arguments. 

Using these variables in a notification script 
allows the same script to be utilized for various jobs, 
since different values may be assigned to the variables 
for each job. You can use, variables in a job 
completion script : or job failure script as determined 
by the product application. 

Table 11 provides a listing of established 
notification script variables, including a description 
of each, variable. . ; , j 

TABLE 11 



This Script Variable 


Represents This Value 


%C (JOB_ID) 


Job identification number 


%C (GR0UP_ID) 


Group identification number 


%C (HOSTNAME) 


-Name f of the host on which the completed 
or ; failed job ran 


%C (INSTANCE) 


Instance name on which the completed or 
failed job ran 


%C ( DS ERNAME ) 


Name of the user 


%C (CONNECT^ STR) 


Connect string 


%C ( JOB_OWNER) 


Owner of object whose job completed or 
failed 


%C (OBJECT) 


Name of object whose job completed or 
failed 


%C (PRODUCT_CODE) 


Product Code 


%C (PRODUCT_VERSION) 


Version number of the product 


%C (DESCRIPTION) 


Job description 



20 



25 
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%C (EMAIL_ADDR) 

> - : 


Notification routing string (the value 
entered in the Notification email 
address field) 


%C(TYPE) 


Job type code, representing JtJie type of 
job that completed or failed 


%C (PIaATHOME) 


Install directory . % 


%C(USERROLE) 


The role .assigned to the user (e.g., 
administrator . - 



A Notification Scripts button on the 6UI interface 
accesses a Notification Scripts window (see Figure 19) . 
The Notification Scripts window allows a user to: 
10 •Modify the text to use for conf irrnation messages 

indicating the completion or failure of a job. 

•Write a customized script using the variables 

specified in this window. 

•Specify the path for the notification email 
15 address used to inform you of the job's completion 

or failure. 

In each of the Job completion script box a.nd Job 

failure script box, a user may enter any of the 
20 predefined script variables to modify default script, 

or simply type in a full path location arid filename for 

a notification script. 

A full path location for a user or notification e- 

mail box address is typed into the Notification email 
25 address box. This method may be utilized to assign. 

notification routing addresses for a pager, email, or 

phone number to deliver the information about the 

scheduled jobs to any location. 
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Scheduling a Calendar 

A Calendar Selection window, see Figure 20, 
accessible from the GUI interface, provides a list of 
the predefined calendars that may be used - with the 
5 current job. Using the options in this window, a user 
can: 

•Create a new calendar. 

•Edit an existing calendar. 

•Select a previously defined calendar. 
10 -Delete a calendar 

To create a calendar, a user selects the Create 
button in the Calendar selection window, which invokes 
the display of a Create Calendar window (see 
Figure 21). The user fills out tlie ID (a name for the 
15 calendar) and Description fields. 

The user may select the* following buttons to 
select the month and year of a date on which the job is 
to run: 

•Select the » button to advance the year by one. 
20 'Select the « button to decrease the year by one. 

•Select the > button to advance to the next month. 
•Select the < button to move back to the previous 
month. 

25 By clicking a day of the month, a red border marks 

the date on the calendar and the complete date displays 
in the Selected dates field. Multiple days may be 
selected. 

Existing calendars may also be modified by 
30 selecting a calendar first by clicking on its ID or 
Description in the available Calendars list in the 
Calendar Selection window and then clicking on the Edit 
button (see Figure 22, for example) . Once the calendar 
is displayed, additional job run dates may be added by 
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25 



selecting a date on the calendar. A user utilizes: 

•Select the >> button to advance the year by one; 
•Select the << button to decrease the year by one; 
•Select the > button to advance /to the -next month; 
-Select the < button to move back to the previous 
month; and' >^ 

then the user clicks on the da;y of the month. A red 
border marks the date oh the calendar and the complete 
date displays in the Selected' date's f ield. The above 
process is repeated until all the dates for running the 
job are displayed iii the Selected dates field: 

Dates may be deleted from the Selected dates list 
by clicking on calendar -numbers marked with red borders 
to deselect . The border on the date disappears when 
deselected and the date no longer displays in the 
Selected dates field. 

The OK button saves the calendar and exits the 
window. The edited calendar is then available in the 
Calendar Selection wiridoW. Clicking the Cancel button 
exits the window without saving changes to the 
calendar. 

A calendar may be selected by clicking on the 
Select button of the GUI interface (Job Scheduling 
window/property page), which displays the Calendar 
Selection window (Figure 20, for example) . A calendar 
is highlighted by clicking on the calendar ID or 
description in the Available Calendars list, arid then 
clicking on the Select button (or double clicking on 
the ID or description) . The calendar selection window 
then closes and the selected calendar ID displays in 
the Calendar ID field on the Job Scheduling window or 
property page. 



A calendar my be deleted using the above procedure 
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by clicking the Delete button instead of the Select 
button from the Calendar Selection window. 

Strategy Scheduling 
5 A Strategy Scheduling window is provided; to view, 

create, modify, or delete schedules for ; a strategy. 
The schedule strategy window is invoked from a point 
product, as shown in Figure 23 . 

A Create button is provided for creating a new 

10 schedule for a current- strategy , which invokes the Job 
Scheduling window/property page (see Figure 24) . The 
Job Scheduling window/property page is then filled out 
for the new schedule. ^ ■ 

An Edit button is provided to modify an existing 

15 schedule for the current strategy , which invokes the 
Job Scheduling window/property page available for 
editing a selected schedule. 

A delete button is provided to delete a schedule 
for the current strategy. A user first highlights a 

20 schedule to be deleted and then clicks on delete. A 
Delete Schedule window prompting for a clean up script 
is then displayed (see Figure 25, for example) . 

The user may either; delete the schedule without 
running a cleanup script by deleting the text (if any) 

25 in the Name of a shell script or other process to run 
to clean up associated files field, or delete the 
schedule and run a cleanup script by typing a path and 
full name of the script. The user invokes the action 
by clicking OK or returning to the Strategy Scheduling 

30 window without deleting by clicking Cancel. 

Job Management Services 

The present invention includes multiple job 
management services that are presented in an easy to 
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use and intuitive format. The present invention 

' utilizes a Jobs resource object to allow a Director 
program to identify and track various job processes. 

After inserting a Jobs resource object into the 
5 Director, a user may perform the following job 

management tasks: 

•View information in the . following formats: 

•Columns - Located on the right side of the 
Director window. 
rlO v •Property pages - Located^ on the right side 

of the Director window. 
•Logfile - Supplied Log File Viewer 
•Delete jobs 
•Rerun jobs 
15 •Cancel job runs 

•Monitor the progress of job runs 

A Jobs resource object provides a bookmark for 
finding information to display, and locating a job to 
20 be acted on when utilizing job management processes 
(deleting or monitoring, a. job, for example) - An Insert 
Object window (see Figure 26) , invoked by the user, 
identifies objects to insert (POEMS provides a number 
of objects that may be inserted, a partial listing is 
,25 provided in Figure 26) . The user selects an object 
(POEMS Scheduling Service, in this example) , - and 
presses OK. In response, a properties page is 
displayed (see Figure 27) , which includes General 
(Figure 28), Representation (Figure 29) , Subscription, 
30 indicators, Job Repository (Figure 30) , and Event 
Correlation tabs. ^ 

The Properties page includes a label and 
description field. The user enters a label and a 
description (description is optional) . 
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The Representation tab allows the user to select, 
in an Intellicdn View, an icon for representing the 
job, and optionally, a background and background color. 
Alternatively, the user may select an icon in Explorer 
view. 

The Intellicon view is show in Figure 29, and 
includes a list of Intellicon icons (provided by POEMS 
files , or alternatively provided by the user) , and a 
display window to view a selected icon (graphic) . An 
example of the Explorer view is illustrated in Figure 
30 , which is an Explorer view displaying Provision 
(point product, or application) Jobs (or LES jobs) as 
the label for a Jobs resource object. ^ 

Selecting the Job repository tab displays a window 
15 for defining a timezone for display of times related to 
jobs. A down arrow pull down menu bar provides the 
user with selections of any timezone. This selection 
does not affect the time or timezone selected for 
running a job as specified, in the Job Scheduling 
20 property page. In one embodiment, daylight savings 
time may be compensated for by providing an automatic 
compensation selector that invokes a program to adjust 
for daylight savings time; alternatively , ^the^se^ i^ 
select a timezone just east of the desired timezone. 

25 

Using Job Resource Objects v 

The Job Resource objects defined by the above 

processes enables a user to locate and view both jobs 

and runs. The user can locate each job in the Explorer 
30 view. Each time a job executes, it creates a new run, 

which then displays in a run folder for the job. 

Each Jobs resource object contains a hierarchy of 

folders sorted into the following categories : 
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•All' Jobs - Lists all jobs regardless of current 
status and also lists all runs by status. 
•Jobs By Group - Lists all jobs arranged by group 
• - ■ Ids. v - v : - : - - • - — 

5 'Jobs; By Node - Lists all j obs arranged by the 

node on which the job runs. 
, : ?Jobs By Product - Lists all jobs arranged by the 

product used for the job. 
: -Jobs By Type - Lists all- jobs arranged by type. 
:10 •Jobs By User - Lists all* jobs arranged- by the 

user who scheduled the: job< : 

However, a point product may not allow a user to assign 
- a ? j ob group or type. The hierarchy of folders is 
15 illustrated in Figure 32. 

The All Jobs Folder (see Figure 33) numerically 
lists all of the jobs instead of categorizing them by 
group/ product or type. The All Jobs Folder lists jobs 
, in folders , including : 
20 •All Jobs ^Any Status; - Lists all jobs regardless 

of status along with associated job history (each 
run of the job). 
Jo •All Runs By Status - Arranges all of the runs of 

jobs into the following folders according to their 
25 ; current status: ; 

•Completed Runs 
•Failed Runs 
•Not Started Runs 
•Preempted Runs 
30 -Running Runs . 

•Stopped Runs : 
•Held Jobs - Lists all of the -jobs that; are held 
and can be scheduled later. 
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•Scheduled Jobs - Lists all of the jobs that aire 
scheduled to run. 

A user can display jobs according to The groups 
assigned to them when they were originally scheduled by 
using the Jobs Group Folder. The specific product 
application (used to run the job) assigns a group, but 
may not use this classification, i 

Jobs may be displayed according to the node on 
which they ran by using the Jobs By Node Folder . 

Jobs may be displayed according to the specific 
product that ran each job by using the Jobs By Product 
Folder. This is helpful if using multiple Provision 
products to schedule and run jobs with the POEMS 
Scheduling Service (helpful because it allows grouping 
of jobs by function or application, for example). 

Jobs may be displayed by job type assigned to them 
when the jobs were originally scheduled by using the 
Jobs by Type Folder. The user's specific product 
application (used to run the job) assigns the job type. 
However, products do not necessarily use this 
classification. 

Jobs may be displayed according Lto the user who 
scheduled the job by using the Jobs By User Folder. 
Each of the Jobs By User, Jobs By Type, Jobs By 
Product, Jobs By Node and Jobs By Group Folders contain 
the same folder hierarchy for each user as that for the 
All Jobs Folder described above. 

Specific jobs may be located by expanding folders 
using the ( + ) signs in the Jobs resource object 
hierarchy. The resulting display includes Job ID, Job 
Icon, and a Job description. 

In addition, a (+) sign of a specific job reveals 
its run history (See Figure 35, for example). 
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The run history is stored in several folders. The 
All Runs folder contains every run regardless of its 
status. The remaining six folders contain only the 
runs that possess the status that applies to that 
5 folder (Completed, Failed, Not Started, Preempted, 
Running and Stopped Runs) . 

Specific runs may he located in the All Runs 
folder and according to its status as illustrated in 
Figure 34. In Figure 34, Run #1 of Job 883 is Stopped; 
10 therefore, it displays in the Stopped Runs folder as 
well as in the All Runs folder. 

Each run listing includes: * : ~» ! 

•Run' icon 
•Rim number 
15 »Run start date and time 

Data can be viewed in column format for all jobs, 
runs, groups , nodes, products, types and users stored 
in a job, runs, groups, nodes, products, or types 
folder. The data displays in columns on the right side 
20 of the Director window when using the Explorer view. 
As shown in Figure 36 > some of the data is shown that 
is available for the jobs in the All Jobs Any Status 
folder under a specific node in the Jobs By Node 
folder. 

25 A user can select any of the following folders to 

view data for their contents in column format (note 
that some folders, such as All Jobs, do not provide 
data) , including: 

•Jobs By Group 
30 -Jobs By Node 

•Jobs By Product 

•Jobs By Type 

•Jobs By User 

•All Jobs Any Status 
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•All Runs By Status 
•Held Jobs 



•Scheduled Jobs 



5 



•All Runs 
•Completed Runs 
•Failed Runs 



•Not Started Runs 



•Preempted Runs 
•Running Runs 



10 •Stopped Runs 

Viewing Job Group Data 

The following data columns display when a user 
clicks on the text of the Jobs By Group folder in a 
15 Jobs resource object: 



•Group ID - Strategy group ID number, 
•Strategy ID - Strategy ID number of the strategy 
defined in the Common Strategy Services to which 
the group belongs. 



user can enter when the group is created. 
•Product Code - Code for the product used to 
create the jobs that can be viewed in this folder. 
•Product Version - Version number of the product 



25 used to create the jobs that can be viewed in this 

folder. 



•Jobs_Per_Run - Number of POEMS Scheduling Service 
jobs submitted by the product for this strategy 
group. 

•Created - Date and time the strategy group jobs 
were generated. 



20 



•Description - Description of the group that the 
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Viewing Node Data 

The following data column displays when the user 
clicks on the text of the Jobs By Node folder in a : Jobs 
resoiirce object: 
5 Node - List of the nodes under which jobs are 

located. 

viewing Product Data 

The following data columns display when the user 
10 clicks on the test of the Jobs By Product folder in a 
? Jobs resource object: 

•Product Code - Gode - f or the product used to 
create the jobs that can be viewed in this folder. 
•Product Version Version number of the product 
15 used to create the j obs that can be viewed in this 

folder. 

■ Viewing Data Typ e 

The following data column displays when the user 
2 0 clicks on the text of the Jobs By Type folder in a Jobs 
resource ob j ect : 

•Type - List of job types. The user can locate 
jobs under their job type, which is assigned in 
the product used to run j obs . 

25 

Viewing User Data 

The following data column displays when the user 
clicks on the text of the Jobs By User folder in a Jobs 
resource object: 
30 -User - List of user names. The user can locate 

jobs listed under user names. 
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Viewing Job Data 

The following data columns display when the user 
clicks on the text of an All Jobs Any Status, Held 
Jobs, or Scheduled Jobs folder in a Job&- resource 
5 object: 

•Job ID - Unique Job ID number. 

•Description - Optional description of the job. 

•Job Group - Strategy group ID number for. the 

group to which the job belongs., 
10 •Access Mode - If this column displays L, the job 

is locked and you cannot rerun the job until the 

job is unlocked. A job is locked and unlocked by 

the point product running the j ob . If a job is 
; not locked this column remains blank, 
15 •Product - Product that created the job. : 

•Type - Job type (product -dependent) • 

•Node - The machine on which the job will run. 

•Whosetz - Time zone to use for scheduling the 

job. 

20 • When Deployed - Time that the job is written into 

the job table. 

•Next Start - This field may contain one of the 
following values or text messages: 

•The next time the job is set to run. 
25 »Run immediately. 

•Expired. 

•Schedule later (held). 
•Run Count - Total number of times the job was 
run. 

30 

Viewing Run Data (Job History) 

The following data columns display when the user 
clicks on the All Runs By Status folder and any folder 
containing runs : 
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•Job ID - Unique Job ID number for this run. 
•Run Number - Unique run number (the number 
assigned to each recurring run of the job) . 
•Group ID - Strategy group ID number of ^ the group 
where the job belongs. 

•Product - PLATINUM Provision product (or other 

product) that created the job. 

•Type - Job type (product -dependent*) . 

•Time Zone - Time zone used for job -runs. 

•Scheduled Start Time - Time the job is scheduled 

to start. 

•Start Status - Status df^ how the job started. 
This status is set by the POEMS: Scheduling Service 
and the column may contain the' -following values: 
•0: Job started successfully. 

•1: Job did not run because the starting time 
passed while the POEMS: Scheduling Service was 
down and the job was not recurring. 
•2 1 Could not execute due to OS status . 
•3: Fork failed due to OS status 
(insufficient system resources) . 
•4: Invalid user. . 

•Actual Start Time - Time when this job run 

actually started. 

•End Time - Date and time when the run completed. 
•OS Status - Provided by the operating system when 
job process could not be created (see your 
operating system documentation for information) . 
•Complt Status - Completion status of the run 
assigned by the point product that rah the job 
(see your product r specif ic documentation for 
information) . 

•Failed - This column may contain the following 
values : 
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•0; Job was successful. 
•1: Job failed for any reason. 
•Preempted - This column may contain the following 
values: — - 

5 •!: Job did not run because it was disallowed 

due to your specific product's operating 
rules . 

•- I: Job was not preempted. 
•Stopped - This column may contain the following 
10 values: 

•1: Job process finished without notifying 
the agent and the status is not known. 
•-1: Job was not stopped. 
•Logf ile - Name and location of the logf ile for 
15 this run. 

Viewing Data in Property Page Format 

Data about specific objects (jobs, runs, groups, 
products, or types) may be viewed within a Jobs 

20 > resource object. The data displays in a property page 
format with one or more tabs on the right side of the 
Director (Explorer view) window. Clicking on the text 
of the object displays the data in property page format 
on the right side of the Director, as illustrated in 

25 Figure 37, accessing the property page data. 

The General property page contains the following 
fields: 

•Job ID - Unique Job ID number. 

•Description - Optional description of the job. 
3 0 •Group ID - Strategy group ID number of the group 

to which the job belongs. 

•Target Node - The machine where the job will run. 
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•Deployed to Target Node - Time when the job is 

written into the job table on ' the node where it 

will run.. ~ 

•Job Type - Job type (product -dependent) : 

•Job Owner - Owner of the object" on which the job 

is performed. 

•Run Count - Number Qf times the job was run. 
•Run S tat e - This column may eohtaifr the fol lowing 

values: ■ - * r - * v J ° : W ' J A 

• 0: Waiting for the next rim-; - ^' 'v- v - 
^1: Currently running^ : ^c, :oJ 
•Scheduling Time Zorie - Time - : zone - of the 
workstation where this job was ' scheduledv 
•Retry Interval (Minutes.) Thi<3^ column may 

contain the f ollowing, vdlues; — 

•Number of minutes to wait befdre- r at tempting 
to rerun the job after a preempted run 
Or 

•0: job will not rerun after- it is preempted. 

•Retry Count - This 1 column may ; contain the 

following values: 

•Number of retry attempts - itiade , on the job 
when it is preempted or is otherwise unable 
to start . ' ,: 

• Or " - : - r - 

•0: the job will not be rerun. 

•Recur Fail Threshold - Number of failed product 

runs accepted before the rescheduling of the job 

is stopped. 

•Recur Fail Count - Used to test if the job has 
failed for a given number of successive runs. 
(The number is decreased with each failure and 
reset to the original value with each successful 
run; if it is 0, the job is not rescheduled.) 
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•Access Mode - If Locked appears, the user, cannot 
rerun the job until the job is unlocked. A job is 
locked and unlocked by the point product running 
the job. If a job is not locked, -this field 
5 remains blank. 

Other Property pages, are displayed by clicking on 
a corresponding tab* The Command property page (see 
Figure 38) contains the following fields: 
10 •Command Line - Command line to execute. 

•E-Mail Completion Notification to - Email address 

used to send job completion or failure 

notification. 

•Completion Script - Job completion script. 
15 -Failure Script - Job failed script. 

•Product Code - Code for the Provision product 
that created the job. 

Databases property page > {see Figure 39) 
20 contains the following fields: 

•Database Connect String - Optional database 
connect string or name used. 

•Database Instance - Name of the instance on which 
the completed or failed job ran, 
25 •Object Name - Name of object whose job completed 

or failed. 

•User ID - Database user ID. 

•User Password - Encrypted database user password. 



30 



Note: The information on this property page is set by 
the point product that runs the job. 

The Job Scheduling property page (see Figure 40) 
displays the following job scheduling selections made 
in the product that ran the j ob : 
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•Start date ana time of the job. 
•Time zone where the job was scheduled. 
Note: If the Use time zone of this workstation button 
is selected, it refers to the workstation- where the job 
5 was s cheduled . ; c , 

•Interval at which the job;> reruns . > 
•Calendar ID of stored calendar used to. run the 
job. This field displays a Calendar ID only if a 
stored calendar was used. 

10 

The parameters tab property page (see Figure 41) 
contains : the following field: 

< \ -Job Parameters i Lists the jobs parameter names 
and valiies; - (The point/ product determines the 
15 contents of this field.) . , . , 

The General tab property page (see Figure 42) 
contains the following f ields : 

•Job ID - Unique Job ID number for this run. 
20 -Run Number - Unique run- number (the number 

assigned to each recurring run of the job) . 

•Time Zone; - Time zone, where the job, runs. 

•Scheduled Start Time - Time when the job is 

scheduled to start. 
25 ^Actual Start Time - Time when this run of the job 

actually started. 

•Start Status - Status of how the job started (set 
by the POEMS Scheduling Service) . 

•Started successfully. - 
30 •Expired - Job did not run because the start 

, time passed while the POEMS Scheduling 
Service was down and the job was not 
recurring . 
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•Agent down - The POEMS Scheduling Service 



agent is down. 



•Fork failed - Process could; not run on agent 



machine due to insufficient system-resources. 



10 



15 



20 



25 



•End Time - Date and time the run completed. 
•Operating System Status - Status of the process 
provided by the operating system. 

•Run Status - One of the following radio buttons 
is selected, indicating the current status of the 



•Completed - The run is finished. 
•Not Started - The run has not started yet. 
•Running - The run is currently in progress. 
•Stopped - The process has finished without 
notifying the agent and the status is not 
known . 

•Preempted - The run was disallowed due to 

point product operating rules. 

•Failed - The run failed due to an 
y unspecified reason. 5 

•Completion Status Code - Completion status of the 
run assigned by the point product that ran the job 
(see product- specific documentation for 
information) . 

•Logfile - Name of the logfile for the job. 

To access the Run Stats tab property page, the 
user clicks on the Run Stats tab to view data on the 
Run Stats property page (see Figure 43 ) . 

The Statistics field displays product -specif ic 
information about this run of the job. This field only 
displays data if data is provided by the Provision, 
Point or other product. 
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Viewing Job Group Data 

To Access job group data: 

•Click on the text of a group In a Jobs resource 
object, the General tab property page, -as shown in 
5 Figure 44, is displayed . 

The General tab property r page (for a: group) 
contains the following fields: 

•Group ID - Strategy group ID numhrer . 
•Description - Optional description of the group. 
10 'Strategy ID - r Strategy ID number of the strategy 

defined in the Commdii : Services Strategy where the 
group belongs i 

•Product Code - code (three- letter Platinum code, 
in one embodiment) for the Provision product used 
15 to create the jobs that can be viewed in this 

folder . 

•Product Version - Version number of t hie Provision 
product, used to create the jobs, which can be 
viewed in this folder. 
20 -Jobs Per Run - Number of POEMS Scheduling Service 

jobs submitted by the product for this strategy 
group. 

-When Created - Date and time the strategy group 
was generated. 

25 

Viewing Loa File Data 

Log files are generated by various Provision 
products, point products, application products, etc (a 
class of software products that include links to the 
30 APIs and related programming as discussed herein) when 
jobs are run. If created, the user can view the log 
files created by products using the POEMS Scheduling 
Service through a Jobs resource object. The user may 
launch a log file viewer. 
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To determine if a log file exists for a given job, 
the user first clicks on the text or the icon of an All 
Runs By Status folder to display the data in column 
format on the right side of the Director window. Then, 
scroll left to view the LOGFIIiE column using the 
horizontal scroll bar or the right arrow (see Figure 

45, for example). If a log file for a run is 
available, its location displays in the row for that 
run in the LOGFILE column . 

To view a log file for a run, the user finds the 
run of the job in a Jobs resource object. Then, right 
clicks on the run to display a popup menu (see Figure 

46, for example). Finally, selecting View Log File 
f rom the popup menu brings up the display shown in 

15 Figure 47. 

Deleting Jobs 

When the user no longer requires a job history , it 
may be deleted using the Jobs Administrator window. 
Either multiple jobs or single jobs may be deleted. 



10 



20 



Deleting Multiple Jobs 

To delete multiple jobs, the Jobs Administrator 
window is accessed at the level of the folder that 
25 contains the jobs to delete in a Jobs resource object. 
Then, a right-click on the icon or text of the folder 
to display the popup menu illustrated in Figure 48. 
Selecting Delete from the popup menu displays the 
Delete Jobs window (see Figure 49) . This window 
displays the Job ID and node name of all of the jobs 
selected in the Submit Jobs/Runs field. 

All of the jobs in a folder are initially selected 
and highlighted. If the user clicks on a job, it is 
deselected and will not be deleted. If all jobs are 



30 
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deselected, the Submit button Becomes inactive. 
Deselect any jobs by either: 

•Click on the jobs one at a time (as shown in 
Figure 49); 
5 Or 

•Use the Select None button to deselect all the 
■■• jobs, and then click on the jobs to delete; 

Or 

10 •Click on the jobs to delete one* >at a time to 

initially deselect them, aind then use* Invert 
button to reverse your selection.-- (This will 
reselect the jobs you deselected and deselect all 

■--others.) ' ' 

15 ■ ■ • " : 1 ^ : ' : ~~" v; ' ' ' " : ' " 

Note: The Select All button may be used to reselect all 

the jobs . ■ 

Clicking on the Submit button deletes the selected 
jobs. The window expands to provide a dynamic display 
20 of the status and results of the action (see Figure 
50). If the deletion of a job completes successfully, 
the job ID and node name for each j ob display in the 
Succeeded field. If the deletion^ of a job fails > the 
job ID, node name, and an error code for that job 
25 display in the Failed field. 

A running total of submitted, succeeded, pending 
and failed deletions displays in the small Submitted, 
Succeeded, Pending, and Failed fields. Alternatively, 
: a user may click on the Close button while the jobs are 
30 deleted without waiting for all of the results to 
display in the expanded window; or wait until all of 
the results (successful or failed) display in the 
Succeeded or Failed fields in the expanded window. The 
Close button then changes to the Done button, which you 
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select to close the Jobs Administrator window. 

Deleting Single Jobs 

To delete single jobs, the Jobs Administrator 
window is accessed at the level of the job to delete in 
a Jobs resource object. The user then locates the job 
to delete and ( right -clicks on the icon or text of the 
job to display a popup menu (see Figure 51) and selects 
Delete. 

The Delete Jobs window then displays (see Figure 
52) . This window shows the Job ID and node name of the 
selected job. If the user clicks on the job, it is 
deselected and the Submit , button .. becomes: ;inactive. 
Clicking the Submit button deletes the jpb> and the 
window expands to provide a dynamic display of the 
status and results of the action (see Figure 53) . 

If the deletion of the job completes successfully, 
the job ID and node name for the job display in the 
Succeeded filed. If the deletion of the job fails, the 
job ID, node name, and an error code for the job 
display in the Failed field. 

A running total of submitted , . succeeded , pending, 
and failed deletions, displays in the. , small Submitted, 
Succeeded, Pending > and Failed fields. 

Rerunning Jobs 

The Jobs Administrator window may be utilized to 
rerun completed jobs using the same parameters . Either 
multiple jobs. or single jobs may be rerun. When a job 
is rerun, a new run number is assigned. In one 
embodiment, locked jobs are prevented from being rerun 
via these procedures. 
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Rerunning Multiple Jobs 

To rerun multiple jobs, the Jobs Administrator 
window/ is accessed at the level of the folder 
containing the jobs to rerun in a Jobs resource object. 
5 The folder containing the jobs to rerun is located, and 
a right-click on the icbn^ or text of the folder 
displays a popup menu (see Figure 54) . Selecting Rerun 
from the popup menu displays the Rerun Jobs window (see 
Figure 55) . This window displays the Job ID and node 
10 name of all of the jobs selected in the Submit 
Jobs /Runs field and provides options for rerunning 
' them. 

Similar to the Delete Jobs procedures discussed 
above, all of the jobs in a folder are initially 
15 selected. If the user clicks on a job, it is 
deselected and will not be rerun* If the user 
deselects all of the j obis , the Submit button becomes 
inactive. 

A user may utilize one of the following options > in 
20 the Start Date & Time specification area by: 

•Clicking on the Run Immeidiately button to rerun 
the jobs immediately; 

- Or < ■ 

25 •Clicking on the Schedule later button to cancel 

the previously scheduled next starting time for 
the jobs .and hold the jobs in the Held Jobs 
folder. 

30 Note: Jobs may be rerun either immediately or 

at a specified time using the Job 
Administrator window (see Rerunning Multiple 
Jobs discussed above) . 
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Or .- ; ^ . . _ , 

•Clicking on the Run at button and type the date 
in the Job Start Date field, or clicking on the 
down arrow to select the date from a- calendar, 
5 then typing, the time in the Job, Start Time field, 

or using the up/down arrows to scroll to the 
desired time. 

r Note: In one embodiment the user must set the 
10 date and time in these fields using the time 

zone originally used to rim the jobs. The 
job times in the Jobs resource object may not 
display in the time zone where the job 
originally ran. 

15 , 

The selected jobs are then rerun at the specified 
date and time. Clicking on the Submit button reruns 
the selected jobs, and the window expands to provide a 
dynamic display of the status and results of the action 

20 (see Figure 56) . 

The. selected jobs are then rerun at the specified 
date and time. Clicking on the Submits button reruns 
the selected jobs, and the window expands to provide a 
.dynamic display of the status and results of the action 

25 (see Figure 56) . If a job is submitted successfully , 
the job ID and node name for each job display in the 
Succeeded field. If a job fails to submit, the job ID, 
node name, and an error code for that job display in 
the Failed field. 

30 A running total of submitted, succeeded, pending, 

and failed reruns displays in the Submitted, Succeeded, 
Pending, and Failed fields; 
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Rerunning Single Jobs 

To rerun single jobs, the Jobs Administrator 
window is accessed at the level of the job to reruii. 
After locating the job to rerun in. the Jobs-folder, the 
5 icon or text of the job is right -clicked to display a 
menu (see Figure 57) , and Rerun is selected, displaying 
the Rerun Jobs window (see Figure 1 58) . This window 
displays the Job ID and node name of the selected job 
and provides options for rerunning it. Clicking the 
vlO job deselects it and the Submit button- becomes 
inactive. Similar start date & time options, as 
" discussed above, are also available. Clicking bh the 
Submit button reruns the job. 

As with the other rerun options, the window 
15 expands to provide a dynamic display of the status and 
results of the submission. 

Canceling Runs 

The user can use the Jobs Administrator to cancel 
20 a; running job. The user can cancel multiple runs or 
single runs of a job. However, some products may 
temporarily disable this capability during a critical 
stage of a job, which does not allow recovery, makes 
: recovery difficult, or requires that the product 
25 specific procedures be followed for recovery. 

Canceling Multiple Runs 

To cancel multiple runs, the Jobs Administrator is 
accessed at the level of the folder containing the runs 
30 to cancel in a Jobs resource object. After locating a 
Funning Runs folder containing the runs to cancel, a 
right -click on the icon or text of the folder displays 
a popup menu (see Figure 59) . 

By selecting Cancel from the popup menu, a Cancel 
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Runs window is displayed (see Figure 60) , This window 
displays the Job ID, run number, and node name of all 
of the runs selected in the Submit Jobs/Runs field (see 
Fig, 57, for example) . • 
5 Similar to the Delete Job procedures, all of the 

runs in a folder are selected initially. By clicking 
on a run, it is deselected and will not be canceled. 
If all of the runs are deselected, the Submit button 
becomes inactive, etc • The Submit button cancels the 
10 selected runs, and the window expands to provide a 
dynamic display of the status and results of the 
action. , 

Monitoring the Progress of Jobs 
15 A Progress Monitor is provided to view information 

about a current phase and overall progress of any job 

run by products using the POEMS Scheduling Service. 

Individual products publish f events regarding the 

different phases of their jobs. The Progress Monitor 
20 subscribes to these events and uses the resulting data 

to provide the user with information on the progress of 

the job. 

The specific progress identifiers and the job 
phases that may be monitored are dependent on the 
25 individual design of the product using the POEMS 
Scheduling Service. 

Access ing the Progress Monitor 

The Progress Monitor may be accessed at the 
30 individual run level in the Jobs Repository Resource 
Object. 

To monitor the progress of a job, a user first 
finds the run of the job and right- clicks on the run to 
display a popup menu (see Figure 61). Selecting 
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Progress Monitor from the popup . menu ; displays the 
Progress Monitor (see Figure 62) . The Progress Monitor 
is configured to display the following information: 

•Name of the current phase of the job*— 
5 "Job ID and run number. 

•Name and/or number of the current phase of the 

job, 

•Current phase number and the time remaining in 
: the current phase - 

10 •Graphical display of the progress; of the current 

phase of the job and the percentage completed of 
. the current phase . 

•Graphical display of the overall progress of the 
.job (including all phases) and the, percentage 
15 completed for the entire job. 

In one embodiment, the contents of the main text 
f ield vary according to the design of the product that 
scheduled the job. 

20 The name of the current phase of the job can be 

viewed from the title bar of the Progress Monitor 
window. The progress of the job's current phase is 
determined by viewing the main text field in the 
Progress Monitor window, or , viewing the Current Phase. 

25 Progress field in the Progress Monitor window. Black 
bars are used to graphically display the phase 
progress. This field also provides the percentage 
completed of the job's current phase. 

The progress for the entire job is viewed using 

30 the Overall Progress field in the Progress Monitor 
window. Again, black bars are used to graphically 
display the overall job's progress, and the percentage 
completed for the entire job. 
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Troubleshooting Tips 

The present invention includes a number of 
troubleshooting techniques. A number of possibilities 
may cause a failure to delete and rerun jobs*r or cancel 
specific runs of a job. 

If a submission fails: 

•Communications to . the local and central 
repositories may not be working. Verify that you 
can communicate with both of the repositories, and 
then submit the request again. 

•The user may have attempted to cancel a run 
during a critical phase of job execution. The 
specific Provision product being used may prevent 
the user from using the cancel feature to avoid a 
potential conflict. , 

•The POEMS Scheduling Service agent (ptlesag.exe) 
may not be running on the node/machine where the 
object is located. Verify that a scheduling 
service agent is running on that machine, and then 
submit the request again. 

To verify that a Scheduling Services agent is 

running on a node , a user selects Tools ► Monitor 

Service Managers from the menu bar to display the 
Director Service Manager Monitor window (see Figure 
63) . The user may click on the plus sign ( + ) or 
double-click on the text of Service Managers to display 
the list of service managers on different riodes . 
Clicking on the text of the service manager for a node 
brings up the right side of the Service Manager Monitor 
with information for the programs residing on that node 
(see Figure 64) . 

The present invention has been described in 
reference to the POEMS Scheduling service utilized by 



NSDOCID: <WO Q038033A2 I > 



WO 00/38033 



PCTVUS99/31024 



- 77 - 



10 



15 



20 



25 



the Platinum suite of database products. However, the 
teachings of the present invention may be applied to 
any individual or suite of computer or' other products 
to provide similar services. Therefore, -tehe present 
invention is not limited to a specific line 6t products 
or type of products (point prdducts, Provision 
products, or databases, for example) and apply to any 
computer processes or applications in general. 

The present invention may be convenient ly 
implemented using a conventional general purpose or a 
specialized digital computer or f microprocessor 
prograiraned according to the ■ teachings ; of -the present 
disclosure, as will be apparent to those skilled in the 
computer art. 

Appropriate software coding can readily be 
prepared by skilled programmers based ori the teachings 
df^ the present disclosure, as will be apparent to those 
skilled in the software art. The invention may also be 
implemented by the preparation of application specific 
integrated circuits or by interconnecting an 
appropriate network of conventional component circuits, 
as will be readily apparent to those skilled in the 
art. - ' * 

The present invention includes a computer program 
product which is a storage medium (media) having 
instructions stored thereon/in which can be used to 
program a computer to perform any of the processes of 
the present invention. The storage medium 5 can include, 
but is not limited to, any type of disk including 
floppy disks, optical discs, DVD, CD-ROMs, microdrive, 
and magneto- optical disks, ROMs, RAMs, BPROMs , EEPROMs , 
DRAMs, VRAMs, flash memory devices, magnetic or optical 
cards, nanosystems (including molecular memory ICs) , or 
any type of media or device suitable for storing 
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instructions and/or data. 

Stored on any one of the computer readable medium 
(media), the present invention includes software for 
controlling both the hardware of the?- general 
5 purpose/specialized computer or microprocessor, and for 
enabling the computer or microprocessor to interact 
with a human user or other mechanism utilizing the 
results of the present invention. Such software may 
include, but is not limited to, device drivers, 
10 operating systems, and user -applications .- Ultimately, 
such computer readable media further includes software 
for performing the present invention, , as described 
above . .. < 

Included in the programming (software) of the 

15 general/specialized computer or, microprocessor are 
software modules for implementing the teachings of the 
present invention, including, but not limited to, 
application programming interfaces for Graphical User 
Interfaces , Job Scheduling, Job Data Management, Job 

20 Administration, a command line interface, calendaring 
functions, and communications across a network. The 
software modules also include job scheduling agents 
operating on individual nodes on computer platforms in 
the network, and modules for the display, storage, or 

25 communication of results according to the processes of 
the present invention. 

Each of the above- described APIs are compiled and 
linked into specific point products. Provision 
products, or other applications utilizing those APIs to 

30 perform the present invention. In addition, 

configuration files are maintained for setup and 
operation of the invention and repositories are 
maintained by the invention. 

Obviously, numerous modifications and variations 
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of the present invention are possible in light of the 
above teachings. It is therefore to be understood that 
within the scope of the appended claims* the invention 
may be practiced otherwise than as specifically 
5 described herein, * - 
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CLAIMS 

What is claimed. is: 

5 1. A job scheduling device for scheduling jobs to 

run on at least one node of at least one computing 
platform, comprising: 

an enterprise scheduling agent installed on each 
node and configured to launch execution of jobs 
10 submitted to the agent; 

a presentation layer configured to accept and 
validate parameters identifying at least one job to be 
submitted for execution on at least one of said nodes; 
and 

15 a job scheduler configured to allocate at least 

one job based on said parameters and submit the 
allocated jobs to at least one enterprise scheduling 
agent . 

20 2 * Th e job scheduling device according to 

Claim l, further comprising: 

a job data management device configured to 
maintain job data and job histories of jobs submitted 
to each enterprise scheduling agent. 



25 



30 



3. The job scheduling device according to 
Claim 2, wherein said job histories include information 
received from each enterprise scheduling agent 
regarding status of the jobs submitted. 

4. The job scheduling device according to 
Claim 2, wherein said job data management device is 
utilized by said job scheduler to set parameters in 
jobs to be submitted to said enterprise scheduling 
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agent. 

5; ■ The job scheduling device According to 
Claim i, further comprising: 
5 a job history repository : - that saves both jobs and 

job histories of jobs submitted to each enterprise 
scheduling agent; 

wherein each enterprise' Scheduling agent 
comprises, 

10 r an agent contaunicato'r configured" to send and 

receive messages between said job Scheduler and the 
enterprise scheduling agent, 

a job manager configured to setup; launch, riin, 
and manage jobs submitted to the enterprise scheduling 

15 ageinb, 

a data manager configured tb update and delete 
data from said job history repository, and 

a low level API configured handle internal 
functions of said enterprise scheduling agent' (LES 
20 Agent) , file management, and message handling 
functions, 

6. The job scheduling device according 1 to 
■ Claim 5, further comprising: 
25 an enterprise communicator configured to construct 

and communicate messages between said job scheduler and 
each enterprise scheduling agent; and 

a job data management device configured to 
; maintain job histories of jobs submitted to each 
30 enterprise scheduling agent; 

wherein said data manager updates said job history 
via enterprise communicator messages sent from the 
enterprise scheduler to said job data management 
device. 
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7. The job scheduling device according to 
Claim 1, further comprising; 

a command line device configured to accept 
commands regarding administration of jobs submitted to 
5 the enterprise scheduling agents;; and 

a job administration device configured to 
communicate said command line to at least one of said 
enterprise scheduling agents for execution. 

10 • : 8 * The job scheduling device according to 

Claim 7, wherein: 

said commands accepted by said command line device 

include at least one of delete a job and all runs of 

the job, cancel a job's run, list all jobs, list all 
15 jobs by at least one of product code, status, and node, 

and rerun a job immediately. 

9- The job scheduling device according to 
Claim 8, wherein: 

20 said commands accepted by said command line device 

include context variables; and 

said enterprise scheduling agent converts said 
context variables according to a current job and job 
parameters, and executes said commands. 
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10. The job scheduling device according to 
Claim 1, further comprising; 

a point product device configured to provide a 
communication link between said enterprise scheduling 
agent and at least one product submitting jobs to said 
job scheduling device; 

wherein said point product device communicates job 
status, job logfile, setup, cancel, job parameter 
functions, and requests between each enterprise 
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scheduling agent and said at least one product. 

11. The job scheduling device according to 
Claim 10, further comprising: ~ ^ 

a job administration device configure* to accept 
5 command line inputs and communicate said command line 
inputs to at least one enterprise scheduling agent; 

a job data management device configured to 
maintain job histories of jobs submitted to each 
enterprise scheduling agent; and - -! 
-10 an, enterprise communicator 'configured to send 

messages between at least one of -said job scheduler, 
point product device, job administration device, and 
j obi^dat a management device- and each of said enterprise 
scheduling agents. 
15 .. - • • • : " - " 

12 . The job scheduling device according to 
Claim 1, further comprising: 

.an enterprise communicator • configured- to send 
messages between said job scheduler and each of -; said 
20 enterprise scheduling agents . 

13. The job scheduling device according to 

Claim 12, wherein: 

. each enterprise scheduling agent is registered at 
25 a specific node address that identifies each enterprise 
scheduling agent with a unique datagroup; and - 

said enterprise communicator encodes each message 
with at least one destination corresponding to a 
datagroup to direct each message to at least one 
.30 enterprise scheduling agent, 

14. The job scheduling device according to 
Claim 1, further comprising: 
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a local job repository installed on each of said 
nodes; 

wherein : 

each local job repository maintains fob and job 
history-information on each job; submitted to the node 
where the local job repository is installed; 

each local job repository is updated by the 
enterprise scheduling agent installed on the node where 
the local job repository is installed; and 

said job information includes job parameters 
needed to execute each job* 

15. The job scheduling device according to 
Claim 14, further comprising: 

a job data management device configured to 
maintain job histories of jobs submitted to each 
enterprise scheduling agent; and 

a synchronizing device configured to synchronize 
each local job repository with the job histories 
maintained by said job data management device. 

16. The job scheduling device according to 
Claim 1, further comprising: 

a progress monitor configured to monitor and 
display execution of at least one of said jobs; 
wherein: 

said progress monitor provides a visual display 

of, 

an identification of said job and a current phase 
of said job, 

a percentage complete of said job, and 

a percentage complete of said current phase. 
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17>. The job scheduling device according to 
Claim l # further comprising: 

an autologin device configured to accept login 
parameters from a user submitting a job; — 
5 :;\ wherein said login' parameters are utilized by an 

enterprise scheduling agent to launch and execute the 
job submitted. 

. - 18'.. The job scheduling device - according to 
10 Claim 1, further comprising: 

a notification scripting device- configured to 
execute a notification script having instructions for 
notifying a user of status of a submitted job; 

wherein said notification scripting device 
15 includes facilities for creating^ editing, and 
selecting a notification script for a specific job. 

19. The job scheduling device according to 
Claim 1, wherein: 

20 said presentation layer includes; 

a GUI interface that accepts user inputs for 
scheduling and specifying a job to be submitted; 

wherein said GUI interface includes facilities for 
- selection and creation of bl scheduling calendar,. 
25 selection of a start date and time, selection of 
recurring job run intervals, and selection of an 
immediate job run. 

20. The job scheduling device according to 
30 Claim 1,. further comprising: 

a resource management device configured to enable 
a user to locate and view jobs and job runs. 
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21. The job scheduling device according to 
Claim 20, wherein: 

said resource management device includes an RM GUI 
for defining an object representing a job, -having, 
5 a general properties page having inpixt fields for 

a label identifying the job, and a description of the 
job, : - 

a description properties page having a selection 
field for identifying an icon for representing the job, 
10 and 

a repository page having a selection field for 
identifying a time zone for display of job times. 

22. The job scheduling device according to 
15 Claim 21, wherein: 

objects defined by said resource management device 
comprise, 

a hierarchy of folders including at least one of 
an all jobs folder, a jobs by group folder, a jobs by 
20 node folder, a jobs by product folder, a jobs by type 
folder, and a jobs by user folder. 

23. The job scheduling device according to 
- Claim 22 , wherein said all jobs folder includes 

25 folders, including, 

an all jobs any status folder listing jobs 
regardless of status and associated job history of each 
job, 

an all runs by status folder listing jobs 
30 according to status, including completed runs, failed 
runs, not started runs, preempted runs, running runs, 
and stopped runs, 

a held jobs folder listing jobs that are held and 
can be scheduled for a later time, and 
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a scheduled jobs folder listing jobs that are 
scheduled to run. 

24. The job scheduling device aeeording to 
5 Claim 1, wherein: 

said presentation layer includes, 

a strategy scheduling window configured to allow 
a user to view, create, modify, and delete schedules 
for a strategy. 
10 : -h^ . . • . - 

25 . A method of scheduling j bbs > across multiple 
networked computing platforms, comprising the "steps of : 

determining at least one job based on job 
rparameters for at least one. job to be scheduled; 
15 sending said at least one job to at least one 

scheduling agent maintained on a selected nodes of said 
computer platforms; and 

executing each job on the selected node under 
management of said scheduling agent. 
20 -• ; ; : - ■ ... - : ■ - - : 

26. The method according to Claim 25, further 
comprising the steps of: 

monitoring progress of the executing job; and 
displaying said progress on a progress monitor. 

25 

27. The method according to Claim 25, further 
comprising the step of recording each job and a history 
of each job in a job history repository. 

30 28. The method according to Claim 27, further 

comprising the step of: 

utilizing a job data management device for. 
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retrieving status messages regarding ea:ch job sent 
from a scheduling agent of a selected node of said job , 
and 

updating said job history repository based on said 
5 status messages. 

29. The method according to Claim 28 > f urther 
comprising the step of: 

maintaining a local job repositories, respectively 
10 on each of said nodes, each containing job and job 
history information for each job submitted to the 
respective node* 

30. The method according to Claim 29; further 
15 comprising the step of: 

synchronizing said job history repository with 
each local job repository. 
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31. The method according to Claim 25/ wherein 
said step of determining comprises the steps of: 

retrieving said job parameters from one of a 
product and a user interface that collects said job 
parameters; 

validating said job parameters; and 

allocating a job based on said job parameters. 



32. The method according to Claim 25, wherein 
said step of sending comprises the steps of: 

packaging said job parameters in a PEC 
30 communication format; and 

transmitting the packaged job parameters from a 
computing platform where said job parameters are 
determined to said scheduling agent maintain on the 
selected node. 
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33.: The method according to Claim 25, wherein 
said step of executing comprises the steps of :. 

setting: up the selected node to run an application 
program identified -by said job parameters; — 
5 .^executing said application program on the selected 

node; and 

j : monitoring progress, of said ^application being 
executed. 

10 -34,: The method according to Claim 25, further 

comprising the steps of: 



jobs submitted to ; said enterprise; scheduling agents ; 
and 

15 communicating said command, line to -at least on e of 



20 .comprising the steps of: 

substituting context variables in said command 
. line with data based on said context variable and the 
job to be administered; and 

executing the, command line.- 



36. The method according to Claim 25, further 
comprising the step of : 

communicating data, including at least one of job 
status, job logfile, setup, cancel, job parameter 
30 functions, and requests for said data between a product 
and each enterprise scheduling agent. 

37. The method according to Claim 25, further 
comprising the steps of : 



accepting a command line for administration of 



said' ' • ••:«. - ■ 

enterprise scheduling agents for execution. 



35. 



The method according to Claim 34, further 
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registering each enterprise scheduling agent at a 
node address that identifies the registered enterprise 
scheduling agent with a unique datagroup; 

communicating j obs and j ob administration commands 
5 and requests with each enterprise scheduling agent via 
messages; and 

encoding each message sent to a recipient 
enterprise scheduling agent with at least one 
destination corresponding to a datagroup that directs 
10 said message to the recipient enterprise scheduling 
agent. 

3&. The method according to Claim 25 > further 
comprising the steps of: 
15 retrieving autologin parameters from a user 

scheduling an autologin job; and 

launching execution of said job ut Hissing said 
autologin parameters. 

39. The method according to Claim 38, further 
comprising the steps of: 

retrieving a notification script for a job being 
submitted; and 

executing the notification script on at least one 
of completion of said job and at a requested status 
point . 

40. The method according to Claim 25, further 
comprising the steps of: 

accepting a scheduling calendar identifying at 
least on of execution times and intervals for at least 
one of said jobs; and 

executing said jobs on selected nodes at the times 
and intervals identified in the calendar. 
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4-1. The method according to Claim 25, further 
comprising the steps of: 

providing a description of at least one of said 
. jobs, including a written description, a lattel, and an 
5 icon selected to represent said job; and 

identifying a tim^ zone for display of job times. 

42. The method according to Claim 25; further 
comprising the steps of: 

10 placing information about job times and statui in 

an object containing folders , each folder identifying 
ai categorization of jobs contained therein, including, 
an all jobs folder,- a jobs by group folder, a jobs fc>y 
node folder, a jobs by product folder, a jobs by type 

15 folder, aLrid a jobs by user folder; 

43. The method according to Claim 42, further 
comprising the step of: 

organizing said all jobs folder to maintain 
20 additional folders, including, at least one of, 

an all jobs any status folder listing jobs 
regardless of status and associated job history of each 
job, 

an ail runs by status folder listing jobs 
25 according to status, including completed runs / failed 
runs, not started runs, preempted runs, running runs, 
and stopped runs , 

a held jobs folder listing jobs that are held krid 
can be scheduled for a later time, and 
30 a scheduled jobs folder listing jobs that are 

scheduled to run. 

44. The method according to Claim 25, further 
comprising the steps of providing a strategy scheduling 
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y?indpw that allows a user to view, create, modify, and 
delete schedules for a strategy. 



instructions stored thereon tli^t, when loaded into a 
computer, cause the computer to perform the steps of: 

determining at least one job based on job 
parameters for at least one job to be scheduled; 

sending said at least one job to at least one 
scheduling agent maintained on r a selected nodes of said 
computer platforms; and , 

executing each job on the selected node under 
management of said scheduling agent. 

46. A job scheduling device for scheduling jobs 
to run on at least one node of at least one computing 
platform, comprising : 

enterprise scheduling means installed on each node 
and configured to launch execution of jobs submitted to 
the enterprise scheduling means ; 

presentation means configured to accept and 
validate parameters identifying at least one j ob to be 
submitted for execution on at least one of said nodes; 
and 

job scheduler means configured to allocate at 
least one job based on said parameters, and submit the 
allocated jobs to at least one enterprise scheduling 



45. 



A computer; readable media-; haying 



means . 
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Job ID 
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Group ID 
Target Node 

Deployed to Target Node 

Job Type 
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/Run Count 
. Run State 

Scheduling Time Zone ; 
Retry Interval (Minutes) 
Retry Count 
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8/19/1998 at T9:38 



Check Reorg Job 
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General Command Databases Job Scheduling Parameters 



Command Line: 

E-Mail Completion Notification: 

Completion Script: 

Failure Script: 

Product Code: 

Product Version: 



SCRIPT] [%C[F_SCRIPT] %C[EMAIL_ADDR] 



plat 



%DMC_HOME/bin/job_completesh%NOTIF_ 



%DMC_HOME/bin/job_fail%NOTIF_ROUTI 



TSR 
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General Command Databases Job Scheduling Parameters 


Database Connect String: 




uitra.world ■: 




Database Instance- 


ora73 S ; 






Object Name: 
User ID: v 


DATA /:':;:...;, 




system 


User Password: ,. 











General Command Databases Job Scheduling Parameters 



r Start Date & Time - 
® Run immediately 
O Schedule later 
O Run at 
Job at date 



■ Job Start Time 
1 June 24.1998 H [3:31:35 PM g 



r Time Zone 



.© Use time zone otthis workstation , , . 

O Use time zone of the node where the job will be run 



p- Recurring Run Interval • — 
®tJone 

O Minutes after each hour 

OHp urs 
ODays 
O Weeks 
O Months 
O Years 



Calendar ID: 



<N0NE> 
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Job Scheduling 



Parameters 



r- Job Parameters 



array_size=5UU 

cache=0 

cluster_opt=1 

commit_size=0 

compile j3roc=0 

compressJevel=5 

conc_idx_bui!d=1 

disableJog_archiving=0 

export„directoryJ=%DMC_TMP 

export_directory_1 0= 

export_directory_2= 

export__directory_3= 

PXPprt rlirprtorv 4= _ 



LL 



export_directory_b= 

exporUdirectoryJ>= 

export_directory_7= _ 

export_directory_8= 

export„directory_9= 

export_type=2 

failure_pred=12 

max.buff erj or Jong=32 

nb_thread=1 

nb_thread_for_concJoad=0 

nbJhread_for_parailelJoad=2 

ora8_skip_objecfc=1 

parallel ftenrPr fi = 1 



parallel, 
parallel, 
partjopt 
part_spr 
part Jab 
partition 
rbseg=1 
recovery 
refresh 
retained 
retaiLe 
retries, 
retry in 



IE 



General | Run Stats | 


Job ID 




Run Number 


ti- ■ :H. 


Time Zone 


I XXX7XXX 1 


Scheduled Start Time 


1 ' ...... 1 : 


Actual Start Time 


1 06/20/1998 at 11:03 I 


Start Status 


| Started Successfully I 




End Time 


I 06/20/1 998 at 11:03 I 
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